Compatibility
Minecraft: Java Edition
1.21.1
1.20.1
Platforms
Supported environments
Creators
Details
Licensed MIT
Published 4 days ago
Updated 2 days ago
Changelog
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Unreleased
Added
- Citizen background and personality system (#1)
- 12 unique backstories for citizens (refugee farmer, disgraced noble, wandering trader, etc.)
- 10 distinct personality traits (cheerful, grumpy, cautious, boastful, etc.)
- 18 possible penalties across criminal, conversation secrets, social, and personal flaw categories
- Background data persistence via NBT serialization
- Configurable backgrounds via JSON config files
- Background display in citizen debug window
- Colony events system (#2)
- Real-time event detection from MineColonies (citizen deaths, births, hires, building completions, job changes, raids)
- Randomly generated flavor events (traveling merchants, bumper harvests, festivals, strange noises, worker disputes)
- Happiness modifiers based on events
- Event context injection into citizen AI prompts
- Configurable event types, durations, happiness modifiers, and generation intervals
- NPC conversation history tracking (#4)
- Persistent NPC memory across server restarts via UUID-based resume
- NPC IDs stored in NBT compound tags for state persistence
- Fixed game session ID for identity consistency
- Conversation history continuity across reloads
- Chat window UI improvements (#3)
- Enter-to-send functionality in chat interface
- Auto-scroll feature in chat history
- Chat tab button in MineColonies citizen window
- Dedicated chat interface for citizen conversations
- Comprehensive Mixin integrations
MixinCitizenManagerfor automatic AI bridge lifecycle managementMixinCitizenDatafor background and conversation history persistenceMixinMainWindowCitizenfor chat UI integrationMixinDebugWindowCitizenfor background information display
- Network messaging system
AIChatMessageandAIChatResponseMessagefor chat communicationBackgroundRequestMessageandBackgroundResponseMessagefor background data syncModNetworkingfor network protocol management
- Configuration system
ModSettingsfor mod-wide configurationBackgroundConfigLoaderfor loading custom background definitionsBackgroundConfigDatafor background data structures
- Client-side functionality
ClientChatHandlerfor handling chat on clientClientBackgroundCachefor caching citizen backgroundsChatWindowCitizenfor chat UI rendering
- NeoForge 1.21.1 support
- Migration from Forge to NeoForge
- Updated mod metadata to
neoforge.mods.toml - Gradle wrapper integration
- Build automation
- GitHub Actions workflow for automated builds
- Automated release workflow (#10)
- GitHub Actions for automated publishing to Modrinth and CurseForge
- Builds and uploads on GitHub release publication
- Uses CHANGELOG.md for release notes
- Configurable disease system (#5)
- Job-specific disease susceptibility modifiers (miners/quarriers 2.0x, healers 0.05x, etc.)
- Configurable contact spread rates per job type
DiseaseConfig.javawith TOML configurationMixinCitizenDiseaseHandler.javafor custom disease spread logic
- Development tools
- VSCode settings for project
- Git attributes configuration
Changed
- Refactored AI bridge architecture
- Renamed
CitizenAIManagertoCitizenNpcManagerfor clarity - Replaced
CitizenAIBridgewithCitizenNpcBridge - Improved conversation management with client-server network protocol
- Enhanced system prompt generation with contextual awareness
- Renamed
- Improved citizen status reporting (#3)
- Added Level 0 → 1 build phrasing in citizen AI prompts
- Enhanced job/request status strings with work order and requester details
- Added null safety guards for citizen status
- Updated dependency management
- Moved MineColonies and related libraries from local
lib/to Maven dependencies - Cleaned up build.gradle configuration
- Moved MineColonies and related libraries from local
- Enhanced .gitignore to exclude build artifacts and IDE files
- Replaced hardcoded healer disease immunity with configurable low-susceptibility modifier (#5)
Removed
- Local library JARs from repository
- blockui-1.20.1-1.0.193.jar
- domum_ornamentum-1.20.1-1.0.290-snapshot-universal.jar
- minecolonies-1.20.1-1.1.989-snapshot.jar
- multipiston-1.20-1.2.43-RELEASE.jar
- structurize-1.20.1-1.0.777-snapshot.jar
- Obsolete Player2 API service classes
HTTPUtils.javaPlayer2APIService.java
- Old Forge metadata (
META-INF/mods.toml) pack.mcmetafileConversationHistory.java(functionality integrated into new bridge)ChatEventHandler.java(replaced byNpcEventHandler.java)
Dependencies
Files
Metadata
Release channel
ReleaseVersion number
v1.0.1Loaders
Game versions
1.21.1Environment
Client and server, required on both
Downloads
5Publication date
February 2, 2026 at 6:50 PMPublisher
elefant-brynte
Member


