Project Sid Society 是一款针对 Minecraft 1.20.1 的实验性多智能体社会模拟器。0.2.1 版本将原本固定的村民转化为拥有角色、目标、关系、文化、税收、议会提案和多数投票的小型社区自治成员,并支持可选的语言模型规划,同时强化了存档验证和服务器执行边界。
本模组灵感来源于 Project Sid: Many-agent simulations toward AI civilization(《Project Sid:迈向 AI 文明的多智能体模拟》)中探讨的理念。它是一个有意保持小巧且可观测的最小可行产品(MVP),旨在作为一个可玩的实验室,而非声称在 500 或 1,000 个智能体规模下能完全涌现出文明。
世界中会发生什么?
播种一个社会,观察村民发展出不同的职责:
- 农民 收割成熟的作物并维持食物供应。
- 矿工 在附近区域寻找煤炭和铁矿。
- 建造者 放置火把等简单基础设施。
- 商人 创造经济事件和社区活动。
- 守卫 巡逻并监视周围环境。
- 探险家 绘制附近领土的地图。
- 牧师 传播该社会的虚构“意大利面教”信仰。
- 组织者 召集议会并传播公民理念。
在预定的议会会议上,当共享金库余额过低或过高时,组织者可以提议改变税率。智能体会根据其社会角色进行投票,多数票即可通过或否决提案,无需操作员发出法律命令。
智能体会保留其 UUID、名称、性格、角色、目标、关系、贡献、转化状态和决策历史。社会还会在世界重启后持久化其宪法、税率、金库和文化模因。
核心特性
- 使用 Minecraft
SavedData 存储持久的智能体档案。
- 服务器端决策循环每几秒运行一次。
- 角色专业化与目标驱动行为。
- 智能体之间的邻近社交关系。
- 虚拟税收与共享社区金库。
- 自主税收提案与确定性多数投票。
- 持久化的宪法与操作员控制的法律。
- 文化模因追踪。
- 虚构宗教与智能体转化事件。
- 重要社会事件的游戏中广播。
- 可选的 OpenAI 兼容型规划器,使用异步 HTTP 请求。
- 无需 API 密钥或互联网连接的确定性本地回退方案。
- 针对社会模拟核心的 JUnit 测试。
- 用于实际模组加载、智能体生成、持久化和税收收集的 Forge GameTests。
快速开始
- 安装带有 Forge 47.4.22 的 Minecraft 1.20.1。
- 将模组 jar 文件放入
mods 文件夹。
- 启动世界并确保你拥有操作员权限。
- 运行以下命令:
/sid seed
这将创建一个初始的八人社会并开始模拟。社会状态在主世界(Overworld)中是全局且权威的;如果已存在社会,/sid seed 命令将拒绝重复创建。有用命令包括:
/sid start
/sid stop
/sid status
/sid list
/sid constitution
/sid governance
/sid spawn Ada MINER
/sid tax set 10
/sid propose tax 25
/sid meme harvest festival
/sid convert Ada
/sid clear
可选 LLM 规划
即使使用本地确定性规划器,本模组也可完全游玩。若要连接 Ollama 服务器或其他 OpenAI 兼容端点,请编辑生成的配置文件:
config/projectsid-common.toml
示例如下:
[llm]
enabled = true
endpoint = "http://127.0.0.1:11434/v1/chat/completions"
model = "llama3.1:8b"
timeoutMs = 5000
可选规划器接收紧凑的智能体快照,并必须返回有界的结构化输出:
ROLE=...
GOAL=...
SAY=...
MEME=...
PREACH=true|false
如果需要身份验证,请通过 SID_API_KEY 环境变量提供令牌。该令牌绝不会存储在模组、世界数据、提示词、日志或受跟踪的配置文件中。远程规划默认禁用,使用时限,限制挂起的请求,并在端点失败时回退到本地行为。
设计理念
Project Sid Society 将模拟规则与 Minecraft 世界集成分离开来:
- 纯 Java 类用于建模角色、档案、关系、税收和文化;
- Forge 服务器管理器在服务器线程上应用完成的决策;
SavedData 保持社会状态的持久化;
- 规划器被视为有界决策的不可信来源;
- 世界修改保持同步并经过验证。
当前范围
这是一个实验性的 MVP。村民被用作智能体的可见载体,感知仅限于附近的方块和实体,贸易目前由虚拟事件表示,治理目前涵盖税收提案而非完整的政治体系。该模组尚未提供基于完整库存的经济系统、平衡性、价格、长期情景记忆、多模态视觉、多村庄政治或自定义实体渲染器。
接下来的计划方向包括真实的库存和价格、情景记忆、多个村庄、冲突以及自定义智能体实体。
要求
- Minecraft 1.20.1
- Forge 47.4.22 或兼容的 Forge 47.x 版本
- Java 17
- 多人游戏时客户端和服务器需安装相同的模组 jar 文件
许可证与归属
Project Sid Society 根据 MIT 许可证发布。它是独立开发的实验性实现,灵感来源于公开描述的 Project Sid 研究。它与原始的 Project Sid 作者无关,也未获得其认可。
状态: 实验性 MVP
Project Sid Society is an experimental multi-agent society simulator for Minecraft 1.20.1. Release 0.2.1 turns persistent villagers into autonomous members of a small community with roles, goals, relationships, culture, taxation, assembly proposals, majority voting, and optional language-model planning, with hardened save validation and server execution boundaries.
This mod is inspired by the ideas explored in Project Sid: Many-agent simulations toward AI civilization. It is an intentionally small and observable MVP, designed as a playable laboratory rather than a claim of a fully emergent civilization at 500 or 1,000-agent scale.
What happens in the world?
Seed a society and watch villagers develop distinct responsibilities:
- Farmers harvest mature crops and support the food supply.
- Miners search nearby areas for coal and iron.
- Builders place simple infrastructure such as torches.
- Traders create economic events and community activity.
- Guards patrol and watch the surroundings.
- Explorers map nearby territory.
- Priests spread the society's fictional Spaghetti faith.
- Organizers call assemblies and spread civic ideas.
At scheduled assemblies, organizers can propose a tax change when the shared treasury is too low or too high. Agents vote according to their social roles, and a majority can approve or reject the proposal without an operator issuing a law command.
Agents keep their UUID, name, personality, role, goal, relationships, contributions, conversion state, and decision history. The society also persists its constitution, tax rate, treasury, and cultural memes across world restarts.
Core features
- Persistent agent profiles stored with Minecraft
SavedData.
- Server-side decision loop running every few seconds.
- Role specialization and goal-driven behavior.
- Nearby social relationships between agents.
- Virtual taxation and a shared community treasury.
- Autonomous tax proposals and deterministic majority voting.
- Persistent constitution and operator-controlled laws.
- Cultural meme tracking.
- Fictional religion and agent conversion events.
- In-game broadcasts for important social events.
- Optional OpenAI-compatible planner using asynchronous HTTP requests.
- Deterministic local fallback that works without an API key or internet access.
- JUnit tests for the social simulation core.
- Forge GameTests for actual mod loading, agent spawning, persistence, and tax collection.
Quick start
- Install Minecraft 1.20.1 with Forge 47.4.22.
- Put the mod jar in the
mods folder.
- Start a world and make sure you have operator permissions.
- Run:
/sid seed
This creates an initial eight-agent society and starts the simulation. The social state is global and authoritative in the Overworld; /sid seed refuses to duplicate an existing society. Useful commands:
/sid start
/sid stop
/sid status
/sid list
/sid constitution
/sid governance
/sid spawn Ada MINER
/sid tax set 10
/sid propose tax 25
/sid meme harvest festival
/sid convert Ada
/sid clear
Optional LLM planning
The mod is fully playable with the local deterministic planner. To connect an Ollama server or another OpenAI-compatible endpoint, edit the generated config file:
config/projectsid-common.toml
Example:
[llm]
enabled = true
endpoint = "http://127.0.0.1:11434/v1/chat/completions"
model = "llama3.1:8b"
timeoutMs = 5000
The optional planner receives a compact agent snapshot and must return bounded structured output:
ROLE=...
GOAL=...
SAY=...
MEME=...
PREACH=true|false
If authentication is needed, provide the token through the SID_API_KEY environment variable. The token is never stored in the mod, world data, prompts, logs, or tracked configuration files. Remote planning is disabled by default, uses timeouts, limits pending requests, and falls back to local behavior if the endpoint fails.
Design philosophy
Project Sid Society separates simulation rules from Minecraft world integration:
- plain Java classes model roles, profiles, relationships, taxation, and culture;
- a Forge server manager applies completed decisions on the server thread;
SavedData keeps the social state persistent;
- planners are treated as untrusted sources of bounded decisions;
- world mutation stays synchronous and validated.
Current scope
This is an experimental MVP. Villagers are used as the visible bodies of agents, perception is limited to nearby blocks and entities, trade is currently represented by virtual events, and governance currently covers tax proposals rather than a complete political system. The mod does not yet provide a full inventory-based economy, balances, prices, long-term episodic memory, multimodal vision, multi-village politics, or a custom entity renderer.
The next planned directions are real inventories and prices, episodic memory, multiple villages, conflicts, and a custom agent entity.
Requirements
- Minecraft 1.20.1
- Forge 47.4.22 or a compatible Forge 47.x build
- Java 17
- The same mod jar on the client and server for multiplayer play
License and attribution
Project Sid Society is released under the MIT license. It is an independent experimental implementation inspired by the publicly described Project Sid research. It is not affiliated with or endorsed by the original Project Sid authors.
Status: Experimental MVP
评论 0
登录后参与评分
还没有评论,来抢沙发吧