Democratic Commands

Democratic Commands

A Minecraft Forge mod that brings democracy to server administration! Non-OP players can propose OP commands that are voted on by all online players.

Features

• Democratic Voting System – Non-OP players can propose OP commands that require community approval
• Automatic Command Interception – Just type OP commands normally – the mod handles the voting automatically
• Full Autocomplete Support – Non-OP players see command suggestions for all OP commands
• Configurable Voting Rules – Set approval thresholds, minimum voters, timeout periods, and more
• Comprehensive Audit Logging – All votes are logged with timestamps, participants, and results
• Smart Abstention Handling – AFK players won’t block votes from completing

Installation

1. Download the latest release from the Releases page
2. Place the .jar file in your server’s mods folder
3. Ensure you’re running Minecraft Forge 1.20.1 (version 47.2.0 or higher)
4. Start your server – the mod will generate a config file on first run

How It Works

1. Non-OP player types an OP command (e.g., /gamemode creative PlayerName)
2. Vote initiates automatically – all online players are notified
3. Players vote using /vote yes or /vote no
4. Vote concludes when:

• Everyone has voted, OR
• The timeout period expires (default: 30 seconds)

1. Command executes if the vote passes based on configured thresholds

Example Workflow

Player1: /weather clear
[Server]: ===== VOTE INITIATED =====
[Server]: Player1 wants to execute: /weather clear
[Server]: Vote using: [YES] [NO]
[Server]: Vote expires in 30 seconds

Player2: /vote yes
Player3: /vote yes
Player1: /vote yes

[Server]: ===== VOTE CONCLUDED =====
[Server]: YES: 3 | NO: 0 | Abstained: 0
[Server]: ✓ VOTE PASSED
[Server]: Command executed successfully!

Commands

| Command | Description | Permission Required |
| ————– | ————————————– | ——————- |
| /vote | Shows help and available vote commands | None |
| /vote yes | Vote YES on the current proposal | None |
| /vote no | Vote NO on the current proposal | None |
| /vote status | Check the status of the current vote | None |

Configuration

The configuration file is located at config/democraticcommands-server.toml and is created on first server start.

Voting Settings

| Setting | Default | Description |
| —————————— | ——- | —————————————————————- |
| voteTimeout | 30 | Time in seconds before a vote automatically concludes |
| minimumVoters | 2 | Minimum players online required to initiate a vote |
| minimumVotesRequired | 2 | Minimum actual votes (not abstentions) for a valid result |
| approvalThreshold | 0.5 | Percentage of YES votes required to pass (0.5 = 50%, 0.66 = 66%) |
| requireMajorityParticipation | true | If true, requires >50% of online players to vote (not abstain) |
| countAbstentionsAsNo | false | If true, abstentions count as NO votes |
| logVotes | true | Enable logging of all votes to file |

Command List

| Setting | Default | Description |
| ———— | ——— | ——————————————————— |
| opCommands | See below | List of commands that require voting when used by non-ops |

Default OP Commands:

opCommands = [
    "gamemode", "gamerule", "give", "tp", "teleport",
    "kill", "ban", "kick", "op", "deop", "whitelist",
    "difficulty", "stop", "setblock", "fill", "summon",
    "effect", "enchant", "weather", "time", "spawnpoint",
    "setworldspawn"
]

Example Configuration

# Require 66% approval with at least 3 votes
voteTimeout = 45
minimumVoters = 3
minimumVotesRequired = 3
approvalThreshold = 0.66
requireMajorityParticipation = true
countAbstentionsAsNo = false
logVotes = true

# Add more commands to the voting system
opCommands = [
    "gamemode", "gamerule", "give", "tp", "teleport",
    "kill", "ban", "kick", "op", "deop", "whitelist",
    "difficulty", "stop", "setblock", "fill", "summon",
    "effect", "enchant", "weather", "time", "spawnpoint",
    "setworldspawn", "scoreboard", "team", "worldborder",
    "xp", "experience", "particle", "playsound"
]

Vote Resolution Logic

A vote passes when ALL of the following conditions are met:

1. ✅ Total votes ≥ minimumVotesRequired
2. ✅ If requireMajorityParticipation is true: More than 50% of online players voted
3. ✅ YES votes ÷ (YES + NO votes) ≥ approvalThreshold
4. ✅ If countAbstentionsAsNo is true: Abstentions are counted as NO votes

A vote fails if any condition is not met, with clear feedback about why.

Audit Logging

When logVotes is enabled, all votes are logged to world/logs/audit.txt:

[2024-01-15 14:32:45] Vote INITIATED
Command: /gamemode creative Player1
Initiator: Player2
YES votes (2): Player2, Player3
NO votes (1): Player4
Abstained (1): Player5
Result: PASSED
----------------------------------------

Troubleshooting

Players can’t see OP command suggestions

• The mod automatically makes whitelisted OP commands visible to all players
• If suggestions aren’t showing, check that the command is in the opCommands list

Votes aren’t triggering

• Ensure the command is in the opCommands configuration list
• Check that minimum voter requirements are met
• Verify the player doesn’t already have OP permissions

Commands execute without voting

• The command might not be in the opCommands list
• The player might have OP permissions (ops bypass voting)

Contributing

Contributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.

Java isn’t my first language, but it is my first mod, so there are probably several things that can be improved.

License

This mod is licensed under the MIT License – see the LICENSE file for details.

Credits

• Created by d-pixie
• Built with Minecraft Forge