SyVote

A powerful Minecraft 1.21.x voting plugin, supporting Purpur / Paper, integrated with the Vault economy system.

---

Features

• Player-Initiated Votes — Regular players can launch server-wide votes on their own
• Vault Economy Integration — Votes can be created with a configurable fee, automatically deducted from the player's balance
• Admin-Configurable Controls — Administrators can freely toggle the player vote-creation permission and adjust the fee
• Server-Wide Broadcasts — Support for broadcasting clickable vote links to all players
• Real-Time Vote Results — Automatically publishes yes/no vote counts and percentages when a vote ends
• Hyperlink-Based Voting — Players can quickly participate by clicking the hyperlink in chat
• Concurrent Votes — Multiple votes can run simultaneously, with a configurable maximum number of active votes per player
• Granular Permissions — Fine-grained permission nodes to flexibly control what each player can do

---

Requirements

Item	Version
Minecraft Server	1.21.x
Server Type	Purpur / Paper
Java	21+
Vault (Optional)	Any version

---

Installation

1. Download SyVote-1.0.0.jar
2. Place the jar file into the server's plugins/ directory
3. Make sure Vault and an economy plugin (e.g. EssentialsX) are installed
4. Restart the server or run /reload confirm
5. Edit plugins/SyVote/config.yml to customize the configuration

---

Commands

Player Commands

Command	Description	Permission
/syvote create <title> <description> [duration]	Create a new vote	syvote.create
/syvote vote <voteId> [yes/no]	Cast a vote on a specified vote	syvote.use
/syvote list	List all active votes	syvote.use
/syvote info <voteId>	View detailed information of a vote	syvote.use
/syvote help	Show the help message	syvote.use

Admin Commands

Command	Description	Permission
/syvote cancel <voteId>	Forcefully cancel a specified vote	syvote.admin
/syvote broadcast <voteId>	Send a vote notification (with a clickable link) to the entire server	syvote.admin
/syvote setcost <amount>	Set the fee players must pay to create a vote	syvote.admin
/syvote togglecreate	Enable/disable the player vote-creation feature	syvote.admin
/syvote reload	Reload the configuration file	syvote.admin

All commands can also be invoked with the aliases /sv or /vote.

---

Permission Nodes

Permission	Default	Description
syvote.use	All players	Use basic voting features
syvote.create	All players	Create votes (subject to the configuration toggle)
syvote.admin	OP	Administrator permission, includes all sub-permissions

---

Configuration File

# Whether to allow players to create votes on their own
allow-player-create: true

# Fee for creating a vote (requires the Vault economy plugin)
create-cost: 100.0

# Default vote duration (in minutes)
default-duration: 10

# Maximum number of concurrent active votes per player
max-active-votes: 3

# Whether to allow players to vote on votes they created
allow-self-vote: false

# Message prefix
prefix: "&b[SyVote] &r"

# Messages (color codes are supported)
messages:
  no-permission: "&cYou do not have permission to perform this action!"
  no-vault: "&cVault economy plugin is not installed; economy features are unavailable!"
  insufficient-funds: "&cYou don't have enough balance; you need &e%cost% &cgold!"
  vote-created: "&aVote created successfully! Cost: &e%cost% &agold."
  vote-ended: "&eVote &6%title% &ehas ended!"
  vote-cancelled: "&cVote &6%title% &chas been cancelled!"
  already-voted: "&cYou have already voted!"
  self-vote-denied: "&cYou cannot vote on a vote you created!"
  vote-not-found: "&cVote not found!"
  no-active-votes: "&cThere are no active votes at the moment."
  max-votes-reached: "&cYou already have too many active votes!"
  player-create-disabled: "&cThe administrator has disabled the player vote-creation feature!"
  broadcast-message: "&6[Vote] &e%creator% &fstarted a vote: &6%title%"
  broadcast-hover: "&aClick to vote!"
  vote-success: "&aVote cast successfully!"
  vote-results: "&6===== Vote Results: %title% ====="
  vote-result-yes: "&aYes: %yes% (&f%yesPercent%%&a)"
  vote-result-no: "&cNo: %no% (&f%noPercent%%&c)"
  vote-result-total: "&eTotal votes: %total%"
  config-reloaded: "&aConfiguration reloaded!"
  create-cost-set: "&aVote creation cost has been set to &e%cost%"
  player-create-enabled: "&aPlayer vote-creation feature has been enabled!"
  player-create-disabled-msg: "&cPlayer vote-creation feature has been disabled!"

---

Usage Examples

Create a Vote (Player)

/syvote create "Enable PVP?" "Should we enable the PVP feature in the spawn area?"

After creation, a clickable broadcast message will be sent to the entire server:

[Vote] Shiyuan started a vote: Enable PVP? (click to vote)

Cast a Vote

Click the vote link in chat, or type the command manually:

/syvote vote vote_1_xxx yes   # Vote yes
/syvote vote vote_1_xxx no    # Vote no

Admin Broadcast

/syvote broadcast vote_1_xxx

Resends a clickable link of the specified vote to the entire server, making it easier to remind players to participate.

Set the Creation Fee

/syvote setcost 500

Sets the cost for players to create a vote to 500 gold.

Disable Player Vote Creation

/syvote togglecreate

After disabling, only administrators with the syvote.admin permission can create votes.

---

Project Structure

SyVote/
├── pom.xml                          # Maven build configuration
├── README.md                        # Project documentation
└── src/
    └── main/
        ├── resources/
        │   ├── plugin.yml           # Plugin descriptor
        │   └── config.yml           # Default configuration file
        └── java/cn/shiyuan/syvote/
            ├── SyVote.java           # Main class
            ├── model/
            │   └── Vote.java         # Vote data model
            ├── manager/
            │   ├── ConfigManager.java    # Configuration manager
            │   ├── EconomyManager.java   # Vault economy manager
            │   ├── MessageManager.java   # Message manager
            │   └── VoteManager.java      # Vote logic manager
            └── command/
                └── VoteCommand.java      # Command handler

---

Building

# Clone the repository
git clone <repository-url>
cd SyVote

# Build with Maven
mvn clean package

# After the build completes, the jar is located at target/SyVote-1.0.0.jar

---