Civilization Endpoint

# Civilization Endpoint

Civilization Endpoint is a server-authoritative, data-driven knowledge network for Forge 1.20.1 progression packs. It turns “what the player is allowed to do” into editable data: branches, nodes, locks, experience sources, eras, and gates.

## What it does

- Lock items, blocks, tags, and dimensions behind unlockable branches.
- Build node costs, prerequisites, requirements, eras, specialization, and decay.
- Add emergence rules, structure discovery, dimension gates, mount gates, barter gates, and lifecycle rules.
- Gate use, place, break, and craft separately with item, tag, and wildcard locks.
- Keep all decisions server-side; the client only renders the synced graph.

## For modpack authors

- `BASIC` mode includes a complete example progression.
- `FRAMEWORK` mode starts empty and only uses author data.
- Edit the graph in-game and export a world datapack.
- Use `/ce validate` to check the graph and mechanics.
- Optional integrations: KubeJS, FTB Quests, Curios, GameStages, and ContentGuard.
- No Mixin, no ASM, and no hard dependency on optional mods.

## Built-in content

The example pack contains:

- 11 branches
- 120 nodes
- 3 eras
- 6 categories
- 36 branch groups
- 120 experience sources
- 2 leap nodes and 9 emergence rules

You can play it as-is or replace it entirely.

## In-game editor

The editor covers branches, nodes, locks, experience sources, mechanics, recipes, loot, icons, categories, eras, and FTB links. It saves to a world datapack and reloads it automatically. The editor is intended for singleplayer or local authoring; use the exported datapack on servers.

## Behavior recorder

Press F8 to record observable actions and write disabled `behaviors.json` candidates. Recording is an authoring helper only: candidates default to disabled and are never used as hard gates. Hard gates still come from content locks, dimension gates, or the API/KubeJS bridge.

## Compatibility

- Minecraft 1.20.1
- Forge 47.1+
- Java 17
- Client and server
- Optional soft dependencies: KubeJS, FTB Quests, Curios, GameStages, ContentGuard

## Installation

1. Install Minecraft 1.20.1 with Forge 47.1 or newer.
2. Put the jar into the `mods` folder on the client and server.
3. Start the game or server.
4. The built-in example data loads automatically; use `FRAMEWORK` mode for an empty pack.

## Known limitations

- The in-game editor and help text are currently Chinese-first. Built-in content and core UI have English translations, and further English coverage is in progress.
- Behavior signatures are heuristic and only grant experience, reveals, or counters; they cannot be used as hard gates.
- Custom mod GUIs, machines, and rituals that do not expose a vanilla event need ContentGuard, KubeJS, or a mod-specific hook.
- The editor is singleplayer-first; server authors should ship the exported datapack.

## AI disclosure

Some code, documentation, and draft assets in this project were produced with AI assistance and reviewed by the author. Gameplay screenshots are actual in-game captures unless individually labeled. The mod does not use AI to generate live in-game content.

## License

MIT. See the LICENSE file included in the jar.

---

## 中文说明

文明端点是一个服务端权威、数据驱动的知识网络模组，适合整合包制作进度门槛：按分支解锁物品、方块、标签和维度，并配置节点成本、前置、纪元、涌现、结构发现和维度门。

内置一套 11 分支 / 120 节点的示例内容，也可以切换到 `FRAMEWORK` 模式从空数据开始。编辑器支持在游戏内修改知识图谱并导出数据包；F8 行为录制只生成默认关闭的候选，不能当硬门禁。

当前编辑器与帮助文本以中文为主，英文内容和核心 UI 已有翻译，后续继续补全。自定义机器、GUI 或仪式如果不对应原版事件，需要 ContentGuard、KubeJS 或模组侧钩子。