Decrees of the Six

Decrees of the Six

A Fabric server-side governance, voting, lightweight economy, and guild system designed for council-style roleplay servers.
The Hexarchate (or any council you define) can create, debate, and vote on decrees in-game, with automatic quorum/majority handling, a season history log, an optional multi-tier currency (Gold/Silver/Copper by default), and player guilds with shared treasuries.

Current version: 0.2.1 (Minecraft 1.21.1, Fabric)

---

Features

• Council seats defined via JSON (council.json).
• Named councils with a configurable councilName used in decree-related messages.
• Council ceremony command to convene or re-convene the council with a server-wide broadcast, configurable chime, and fireworks.
• Configurable council ceremony sound via ceremonySound in council.json (e.g. decrees_of_the_six:council_chime).
• Decrees with lifecycle: DRAFT → VOTING → ENACTED/REJECTED/CANCELLED.
• Configurable voting rules (quorum, duration, majority mode, ties).
• Global toggles: enable/disable the whole decree system or restrict it to ops.
• Seat tools for assigning council members.
• Join reminder for council members with pending votes.
• One-vote-remaining ping when only one seat is left to vote on a decree.
• Paginated decree lists & in-game history via /decrees decree list [page] and /decrees history [page].
• Status-filtered decree lists via /decrees decree list status <draft|voting|enacted|rejected|cancelled> [page].
• “My decrees” & active lists with pagination via /decrees decree list my [page] and /decrees decree list active [page].
• Seat statistics & status helpers via /decrees stats ... and /decrees status [id].
• Clean chat formatting & tab completion for decree IDs, seat IDs, and categories.
• Clickable vote hints (buttons [Yes] [No] [Abstain]) for council members when a decree is opened.
• Text log of final decrees for season history.
• Optional guild system:
• Player-created guilds with ranks (Leader / Officer / Veteran / Member / Recruit),
• Per-guild customizable rank titles,
• Each guild has its own Treasury account in the same economy,
• Vox Imperion tools for inspecting and moderating guilds.
• Optional Hexarchate Panel UI (G-key) (if the client also loads the mod) with:
• A Ledger tab for player balance and transactions,
• A Guild tab showing guild name, rank, member counts, and guild Treasury balance, plus quick actions (deposit / leave / accept invites).
• All interaction done in-game via /decrees, /money, /economy, /guild, and /vox guild commands.

---

Economy / Money System

• Optional single currency with three denominations (default: Gold, Silver, Copper Scales).
• Configurable names and conversion ratios via economy_config.json.
• Persistent JSON-backed store of accounts and transactions (per-player account + global Treasury account + guild Treasuries).
• Player commands (/money) for checking balances, paying other players, and viewing your own transaction log.
• Admin commands (/moneyadmin) for granting / seizing money and managing the Treasury.
• Economy meta commands (/economy) for help and live reloading of economy config.
• Amounts are always shown in G/S/C form (e.g. 2G 4S 30C Scales).
• G-key “Hexarchate Panel” UI (client-side optional):
• Ledger tab:
• Player name and balance in G/S/C,
• Recent transactions formatted in G/S/C.
• Guild tab:
• Guild name and your guild rank/title,
• Leader and member counts per rank,
• Guild Treasury balance in G/S/C,
• Pending invite count,
• Quick buttons to deposit, leave, or accept invites (front-end to /guild commands).

---

Guilds & Vox Imperion

The guild system is fully server-side and uses the same economy backend. Guilds are stored persistently in a world data file managed by the mod (not meant to be edited manually).

Guild Basics

• A player can be a member of at most one guild at a time.
• Each guild has:
• A unique internal ID and a name,
• A Leader (player UUID),
• Members with one of 5 ranks:
• Leader, Officer, Veteran, Member, Recruit,
• A Treasury account in the economy system,
• Optional settings: MOTD/description, open-join flag, and max members.
• Each guild can customize the display titles for ranks:
• e.g. Leader = "High Chancellor", Officer = "First Blade", etc.

Guild Ranks & Titles

Internal permission roles:

• Leader – full control.
• Officer – strong management powers.
• Veteran – minor management powers.
• Member – normal access, no management.
• Recruit – probationary / newcomer.

Each role can have a guild-specific title, set by the guild leader, for flavour/RP. Internally, permissions are based on the roles; titles are just display.

---

Requirements

• Minecraft: 1.21.1 (adjust if you built for a different version).
• Fabric Loader (matching your server version).
• Fabric API.

This is primarily a server-side mod. Clients do not need to install it to use /decrees, /money, or /guild commands.
Installing the mod on the client is optional but enables the G-key “Hexarchate Panel” screen.

---

Installation (Server Owners)

1. Build or download the mod JAR (usually in build/libs/).
2. Place the JAR into your server’s mods/ folder.
3. Start the server once to generate default config files.
4. Edit the config files under:

config/decrees_of_the_six/council.json
config/decrees_of_the_six/voting_rules.json
config/decrees_of_the_six/economy_config.json

1. Use /decrees reload and /economy reload in-game (as an op) after editing configs, or restart the server.

Guild and economy data stores (accounts, transactions, guilds) are managed automatically by the mod and saved on server shutdown. They should not be edited by hand.

---

Configuration

1. council.json

Defines global flags, the council name, ceremony sound, and council seats.

Example:

{
“councilName”: “Hexarchate of Salmon”,
“decreesEnabled”: true,
“opsOnly”: false,
“ceremonySound”: “decrees_of_the_six:council_chime”,
“seats”: [
{
“id”: “overseer_regent”,
“displayName”: “Overseer-Regent”
}
]
}

Fields:

• councilName (string, optional)
• Friendly display name of your council (e.g. "Hexarchate of Salmon").
• Used in decree-related messages and flavour text.
• Can be set manually or via /decrees council create <name>.

• decreesEnabled (boolean)
• true → all decree features work normally.
• false → decree creation, opening, voting, etc. are disabled (players get a message).

• opsOnly (boolean)
• false → only council seats can create/open/vote (normal mode).
• true → only ops can create/open/delete/vote on decrees (safety mode / emergency override).

• ceremonySound (string, optional)
• Resource location of the sound event used for the council ceremony broadcast.
• Example: "decrees_of_the_six:council_chime" for a sound defined in your sounds.json.
• If missing or invalid, the mod falls back to a vanilla toast sound.

• seats (array) – each seat:
• id – internal ID (e.g. "overseer_regent"). Used in saves & logs.
• displayName – pretty name shown in chat (e.g. "Overseer-Regent").
• holderUuid (optional) – UUID of the player currently holding that seat.

You typically assign seat holders in-game using /decrees seat set instead of editing holderUuid by hand.

/decrees council create <name> will:

– Set councilName to <name>,

– Force decreesEnabled = true,

– Force opsOnly = false.

---

2. voting_rules.json

Controls how votes are evaluated.

Example:

{
“minQuorumPercent”: 60,
“votingDurationMinutes”: 30,
“majorityMode”: “SIMPLE”,
“tiesPass”: false
}

Fields:

• minQuorumPercent Minimum % of active seats that must vote for the decree to be valid. Example: 60 with 5 active seats → at least 3 votes needed.

• votingDurationMinutes How long voting stays open once a decree is opened. 0 or less → no time limit (will resolve when everyone votes or via force).

• majorityMode
• "SIMPLE" → more YES than NO and at least half + 1 of the votes.
• "TWO_THIRDS" → at least 2/3 of the votes must be YES.

• tiesPass
• true → YES = NO counts as ENACTED.
• false → YES = NO counts as REJECTED.

---

3. Decree History Log

Finalised decrees (status becomes ENACTED, REJECTED, or CANCELLED) are appended to a history log, e.g.:

config/decrees_of_the_six/decrees_history.log

The log typically includes:

• Timestamp
• Decree ID and title
• Final status
• Who forced it (if done via /decrees decree force)
• A compact summary of votes

This is meant for season records / lore.

---

4. economy_config.json

Controls how the currency behaves and how amounts are displayed.

Example:

{
“enabled”: true,
“currencyName”: “Scales”,
“goldName”: “Gold”,
“silverName”: “Silver”,
“copperName”: “Copper”,
“copperPerSilver”: 10,
“copperPerGold”: 100
}

Fields (high level):

• enabled (boolean)
• If false, the money system is effectively disabled (commands will refuse to run).

• currencyName (string)
• Base display name, e.g. "Scales", "Crowns", "Marks".

• goldName, silverName, copperName (strings)
• Display names for each denomination.
• Used in chat and UI.

• copperPerSilver, copperPerGold (ints)
• Conversion rates to the smallest unit (copper).
• Example above → 1 Silver = 10 Copper, 1 Gold = 100 Copper.

Economy data (accounts + transactions + guild Treasuries) is stored in a separate JSON file (e.g. economy_store.json) next to your other Decrees config. It is not meant to be edited by hand.

---

How Council Seats Work

Seats are defined in council.json under "seats".

• A player can hold at most one seat.
• Assigning a new seat will clear any previous one.

Seats are used to:

1. Determine who may create/open/delete decrees.
2. Determine who may vote (each seat = one vote).
3. Show “your vote” in /decrees decree list active.
4. Drive join reminders and “one vote left” pings.

Managing Seats (Ops Only)

All seat management commands are op-only:

• /decrees seat list Shows all seats, their display names, and current holder (player name or <empty>).

• /decrees seat set <seat_id> <player> Assigns a player to a seat. If the player already holds a different seat, that old seat is cleared automatically.

• /decrees seat clear <seat_id> Removes the holder from a seat (seat becomes empty).

---

Decree Lifecycle (Council Workflow)

Typical flow for a council session:

1. Create a decree (DRAFT) A council member runs:

/decrees decree create