SaySomething
A Minecraft Mod that connects villagers to remote AI models.
We are seeking for new features
If you have any idea that will improve my mod, please open a discussion on GitHub!
I'll consider every idea, and give replys. If it looks cool and I can implement it, I will!
Basic information
Wiki
See wiki here.
Also you can checkout wiki indexed by DeepWiki here.
Features
-
Multiple AI platforms support.
-
Make use of villager's data, such as trades and profession.
-
Auto conclude conversation so that it won't get too long.
Versions
-
1.2 (26.1, 26.2)
-
1.1.1 (1.21.1, 1.21.11)
-
1.1 (1.21.1, 1.21.4, 1.21.5, 1.21.7, 1.21.11)
-
1.0 (1.21)
-
0.3 (1.21)
-
0.2 (1.20.1)
-
0.1 (1.20.1, 1.21)
License
Sample configurations
config.json:
{
"personalities": [
"decisive",
"confident",
"motivational",
"analytical",
"introspective",
"creative",
"empathetic",
"supportive",
"nurturing",
"spontaneous",
"curious",
"energetic",
"diplomatic",
"harmonious",
"patient",
"imaginative",
"visionary",
"resourceful",
"practical",
"down-to-earth",
"reliable",
"charismatic",
"expressive",
"entertaining",
"knowledgeable",
"curious",
"detail-oriented",
"ambitious",
"inspirational",
"forward-thinking"
],
"nameCandidates": [
"Steve",
"Alex",
"Jeb",
"Lily",
"Akane",
"Kubo",
"Joker"
],
"conclusionMessageLimit": 10,
"villagerChatPrefix": "$",
"useExistingVillagerName": true,
"showTimeConsumption": false,
"timeoutSeconds": 10,
"apiConfigPlatform": "cloudflare"
}
api-config.json:
{
"modelName": "@cf/qwen/qwen1.5-14b-chat-awq",
"accountId": "<Your Cloudflare account ID>",
"apiKey": "<Your API key with proper permissions>"
}
Attention
If you are using v1.0 with OpenAI platform and some issues occurred, please refer to this page first.
How to Install SaySomething (Mod)
SaySomething by Ranzeplay is verified for Fabric, Forge, Neoforge across Minecraft versions 1.20.1, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4 (latest release: 1.2, file size: 54 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.20.1, 1.21, 1.21.1, 1.21.10, 1.21.11, 1.21.2, 1.21.3, 1.21.4) and platform (Fabric, Forge, Neoforge).
- Make sure you have the compatible loader or environment installed for Fabric, Forge, Neoforge.
- Move the downloaded SaySomething file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 8d ago | 1 | ||||
| 8d ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 11mo ago | 1 | ||||
| 11mo ago | 1 | ||||
| 11mo ago | 1 | ||||
| 11mo ago | 1 | ||||
| 11mo ago | 1 | ||||
| 11mo ago | 1 | ||||
| 11mo ago | 1 | ||||
| 11mo ago | 1 | ||||
| 11mo ago | 1 | ||||
| 11mo ago | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 | ||||
| last yr. | 1 |
but however, there are some good news for both players and developers.
<!-- truncate -->
# Overview
- Support Minecraft 26.1.
- No longer require Architectury API as a dependency.
- Documentation enhancement.
# Features
- Support Minecraft 26.1.
- No longer require Architectury API as a dependency.
- Improve error handling.
- Add text-based Cloudflare platform configuration tutorial.
- Update project dependencies.
# Fixes
- Fix the issue where default profession prompts could not be extracted.
# Pull Requests
- Improve Java code: resource management, null safety, edge case handling, and logging by @Copilot in https://github.com/Ranzeplay/saysth/pull/45
- 44 a tutorial for users on setting up the cloudflare requirements by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/48
- Full Changelog**: https://github.com/Ranzeplay/saysth/compare/v1.1.1-f1...v1.2
For more details, see the latest [wiki](https://saysth.ranzeplay.space/docs/intro).
We hope you enjoy the new version.
but however, there are some good news for both players and developers.
<!-- truncate -->
# Overview
- Support Minecraft 26.1.
- No longer require Architectury API as a dependency.
- Documentation enhancement.
# Features
- Support Minecraft 26.1.
- No longer require Architectury API as a dependency.
- Improve error handling.
- Add text-based Cloudflare platform configuration tutorial.
- Update project dependencies.
# Fixes
- Fix the issue where default profession prompts could not be extracted.
# Pull Requests
- Improve Java code: resource management, null safety, edge case handling, and logging by @Copilot in https://github.com/Ranzeplay/saysth/pull/45
- 44 a tutorial for users on setting up the cloudflare requirements by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/48
- Full Changelog**: https://github.com/Ranzeplay/saysth/compare/v1.1.1-f1...v1.2
For more details, see the latest [wiki](https://saysth.ranzeplay.space/docs/intro).
We hope you enjoy the new version.
- Improve logging details
- Add Simplified Chinese as a documentation language
- Improve documentation quality
- Conclusion prompt customization
- Upgrade project dependencies
- Per-profession villager system prompt customization
- Add commands for debugging
# Fixes
- Issues reported by GitHub Dependabot
- Logger name in game console (server and client)
- Empty prompt handling
# Pull requests
- Bump nanoid from 3.3.7 to 3.3.8 in /docs by @dependabot[bot] in https://github.com/Ranzeplay/saysth/pull/23
- Issue #27 prototype by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/29
- Bump org.projectlombok:lombok from 1.18.36 to 1.18.38 by @dependabot[bot] in https://github.com/Ranzeplay/saysth/pull/31
- Update README.md by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/32
- Update README.md for new Minecraft version by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/33
- Potential fix for code scanning alert no. 2: Workflow does not contain permissions by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/36
- 34 minecraft 1216 compatibility issue by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/37
- Potential fix for code scanning alert no. 6: Arbitrary file access during archive extraction ("Zip Slip") by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/35
- Add DeepWiki badge to README by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/42
- Port to 1.21.11 by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/43
- Full Changelog**: https://github.com/Ranzeplay/saysth/compare/v1.1...v1.1.1
For more details, see the latest [wiki](https://saysth.ranzeplay.space/docs/intro).
We hope you enjoy the new version.
- Improve logging details
- Add Simplified Chinese as a documentation language
- Improve documentation quality
- Conclusion prompt customization
- Upgrade project dependencies
- Per-profession villager system prompt customization
- Add commands for debugging
# Fixes
- Issues reported by GitHub Dependabot
- Logger name in game console (server and client)
- Empty prompt handling
# Pull requests
- Bump nanoid from 3.3.7 to 3.3.8 in /docs by @dependabot[bot] in https://github.com/Ranzeplay/saysth/pull/23
- Issue #27 prototype by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/29
- Bump org.projectlombok:lombok from 1.18.36 to 1.18.38 by @dependabot[bot] in https://github.com/Ranzeplay/saysth/pull/31
- Update README.md by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/32
- Update README.md for new Minecraft version by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/33
- Potential fix for code scanning alert no. 2: Workflow does not contain permissions by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/36
- 34 minecraft 1216 compatibility issue by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/37
- Potential fix for code scanning alert no. 6: Arbitrary file access during archive extraction ("Zip Slip") by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/35
- Add DeepWiki badge to README by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/42
- Port to 1.21.11 by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/43
- Full Changelog**: https://github.com/Ranzeplay/saysth/compare/v1.1...v1.1.1
For more details, see the latest [wiki](https://saysth.ranzeplay.space/docs/intro).
We hope you enjoy the new version.
- Improve logging details
- Add Simplified Chinese as a documentation language
- Improve documentation quality
- Conclusion prompt customization
- Upgrade project dependencies
- Per-profession villager system prompt customization
- Add commands for debugging
# Fixes
- Issues reported by GitHub Dependabot
- Logger name in game console (server and client)
- Empty prompt handling
# Pull requests
- Bump nanoid from 3.3.7 to 3.3.8 in /docs by @dependabot[bot] in https://github.com/Ranzeplay/saysth/pull/23
- Issue #27 prototype by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/29
- Bump org.projectlombok:lombok from 1.18.36 to 1.18.38 by @dependabot[bot] in https://github.com/Ranzeplay/saysth/pull/31
- Update README.md by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/32
- Update README.md for new Minecraft version by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/33
- Potential fix for code scanning alert no. 2: Workflow does not contain permissions by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/36
- 34 minecraft 1216 compatibility issue by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/37
- Potential fix for code scanning alert no. 6: Arbitrary file access during archive extraction ("Zip Slip") by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/35
- Add DeepWiki badge to README by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/42
- Port to 1.21.11 by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/43
- Full Changelog**: https://github.com/Ranzeplay/saysth/compare/v1.1...v1.1.1
For more details, see the latest [wiki](https://saysth.ranzeplay.space/docs/intro).
We hope you enjoy the new version.
- Improve logging details
- Add Simplified Chinese as a documentation language
- Improve documentation quality
- Conclusion prompt customization
- Upgrade project dependencies
- Per-profession villager system prompt customization
- Add commands for debugging
# Fixes
- Issues reported by GitHub Dependabot
- Logger name in game console (server and client)
- Empty prompt handling
# Pull requests
- Bump nanoid from 3.3.7 to 3.3.8 in /docs by @dependabot[bot] in https://github.com/Ranzeplay/saysth/pull/23
- Issue #27 prototype by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/29
- Bump org.projectlombok:lombok from 1.18.36 to 1.18.38 by @dependabot[bot] in https://github.com/Ranzeplay/saysth/pull/31
- Update README.md by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/32
- Update README.md for new Minecraft version by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/33
- Potential fix for code scanning alert no. 2: Workflow does not contain permissions by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/36
- 34 minecraft 1216 compatibility issue by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/37
- Potential fix for code scanning alert no. 6: Arbitrary file access during archive extraction ("Zip Slip") by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/35
- Add DeepWiki badge to README by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/42
- Port to 1.21.11 by @Ranzeplay in https://github.com/Ranzeplay/saysth/pull/43
- Full Changelog**: https://github.com/Ranzeplay/saysth/compare/v1.1...v1.1.1
For more details, see the latest [wiki](https://saysth.ranzeplay.space/docs/intro).
We hope you enjoy the new version.
<!-- truncate -->
## Features
- Add detailed logging when chat fails.
## Fixes
- No longer need to add
Bearerto the front of OpenAI platform API keys.
For more details, see the latest [wiki](https://saysth.ranzeplay.space/docs/intro).
We hope you enjoy the new version.