# GameVoting<\/p>\n
\n
\n
\n<\/p>\n
\u4e2d\u6587\u6587\u6863 | User Guide | \u4f7f\u7528\u6587\u6863<\/p>\n
A powerful and feature-rich Minecraft voting system plugin for Paper servers, designed for CloudNet v4 network environments. Support for automatic game selection, player ready system, holographic displays, and multi-database persistence.<\/p>\n
## \u2728 Features<\/p>\n
### \ud83c\udfae Voting System
\n– **Multi-phase Voting Flow**
\n – Automatic item distribution based on player count (\u22656 players)
\n – Pre-voting ready phase with emerald trigger items
\n – Voting phase with compass menu interface
\n – Post-voting ready phase with dye-based ready indicators<\/p>\n
– **Smart Player Ready System**
\n – Players receive emerald items when \u22656 players online
\n – Right-click to mark ready\/unready status
\n – Automatic voting start when all players are ready
\n – Real-time hologram updates showing ready count<\/p>\n
– **Flexible Voting Modes**
\n – Manual start: `\/vote start [duration]` – Always starts voting immediately
\n – Automatic start: Emerald ready system triggers voting when all players ready
\n – Custom voting duration (default 60 seconds)<\/p>\n
### \ud83d\udcca Holographic Displays
\n– **Dynamic Display States**
\n – Idle: Historical top 10 winning games with vote counts
\n – Pre-voting Ready: Shows ready player count and progress
\n – Voting Active: Current available games with live vote counts
\n – Vote Ended: Top 10 voted games from current session
\n – Post-teleport: Returns to historical top 10<\/p>\n
– **Multi-location Support**
\n – Create holograms at any location with `\/vote holograms create`
\n – Automatic synchronization across all hologram locations
\n – List and remove holograms with simple commands<\/p>\n
### \ud83d\uddc4\ufe0f Database Integration
\n– **Multi-database Support**
\n – PostgreSQL (recommended for production)
\n – MySQL\/MariaDB
\n – MongoDB
\n – Optional: Can run without database<\/p>\n
– **Vote History Tracking**
\n – Records winning game, total votes, player count
\n – Stores detailed vote breakdown per game
\n – Timestamp-based historical analytics
\n – Automatic top 10 winner statistics<\/p>\n
### \ud83c\udf10 CloudNet Integration
\n– **Seamless Service Management**
\n – Automatic CloudNet service detection
\n – Service status-based game filtering
\n – Player teleportation via proxy commands
\n – Only teleports players who actually voted<\/p>\n
– **Service Configuration**
\n – Game-to-service mapping via `games.yml`
\n – Configurable service name patterns
\n – Support for multiple services per game type<\/p>\n
### \ud83c\udf0d Internationalization
\n– **Multi-language Support**
\n – English (en-US, en-UK)
\n – Simplified Chinese (zh-CN)
\n – Easy to add custom languages<\/p>\n
– **Complete Translation Coverage**
\n – All commands, messages, and UI elements
\n – Item names and lore
\n – Hologram displays
\n – Error messages and feedback<\/p>\n
### \ud83c\udfaf Advanced Features
\n– **Smart Item Management**
\n – Automatic item distribution in slot 9
\n – Different items for different server states
\n – Undropable vote items with persistent data
\n – Color-coded ready status indicators<\/p>\n
– **Party System Integration**
\n – Create and manage player parties
\n – Party-based game teleportation
\n – Party member management<\/p>\n
– **Robust Permission System**
\n – Fine-grained permission control
\n – Admin vs player command separation
\n – Configurable access levels<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Server**
\n – Paper 1.16 or higher (Spigot\/Bukkit not supported)
\n – Java 17 or higher
\n – CloudNet v4 (4.0.0-RC10 or higher)<\/p>\n
– **Dependencies**
\n – DecentHolograms 2.8.6+ (for hologram displays)
\n – CloudNet Driver & Bridge modules<\/p>\n
– **Optional**
\n – PostgreSQL 12+ \/ MySQL 8.0+ \/ MongoDB 5.0+ (for vote history)<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
1. **Download the plugin**
\n “`bash
\n # Build from source
\n git clone https:\/\/github.com\/yourusername\/GameVoting.git
\n cd GameVoting
\n mvn clean package
\n “`<\/p>\n
2. **Install dependencies**
\n – Download and install DecentHolograms
\n – Ensure CloudNet v4 is properly configured<\/p>\n
3. **Deploy the plugin**
\n “`bash
\n # Copy the compiled JAR to your plugins folder
\n cp target\/GameVoting-1.1.0.jar \/path\/to\/server\/plugins\/
\n “`<\/p>\n
4. **Configure the plugin**
\n – Start the server to generate default configuration files
\n – Edit `plugins\/GameVoting\/config.yml`
\n – Configure `plugins\/GameVoting\/games.yml`
\n – Restart the server<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
### config.yml
\n“`yaml
\n# Debug mode for detailed logging
\ndebug: false<\/p>\n
# Language: en-US, en-UK, zh-CN
\nlanguage: “en-US”<\/p>\n
# CloudNet proxy service name
\nproxy-service-name: “Proxy-1”<\/p>\n
# Database configuration
\ndatabase:
\n enabled: true
\n type: “postgresql” # postgresql, mysql, mongodb
\n host: “localhost”
\n port: 5432
\n database: “gamevoting”
\n username: “postgres”
\n password: “password”<\/p>\n
# Hologram locations (managed via commands)
\nholograms:
\n locations: []
\n“`<\/p>\n
### games.yml
\n“`yaml
\ngames:
\n – id: “skywars”
\n name: “SkyWars”
\n service-name: “SkyWars-{number}”
\n icon: “GOLDEN_SWORD”
\n description: “Fight in the sky!”<\/p>\n
– id: “bedwars”
\n name: “BedWars”
\n service-name: “BedWars-{number}”
\n icon: “RED_BED”
\n description: “Protect your bed!”
\n“`<\/p>\n
## \ud83d\udcd6 Usage<\/p>\n
### For Players<\/p>\n
1. **Automatic Voting (\u22656 players)**
\n “`
\n – Wait for emerald item in slot 9
\n – Right-click to mark ready
\n – Voting starts when all players ready
\n “`<\/p>\n
2. **Manual Voting**
\n “`
\n – Admin starts: \/vote start
\n – Receive compass in slot 9
\n – Right-click to open voting menu
\n – Select your preferred game
\n “`<\/p>\n
3. **Post-voting Ready**
\n “`
\n – Receive gray dye after voting ends
\n – Right-click to mark ready
\n – Changes to lime dye when ready
\n – Game starts when all players ready
\n “`<\/p>\n
### For Administrators<\/p>\n
“`bash
\n# Start voting manually
\n\/vote start [duration]<\/p>\n
# Force start game (skip ready phase)
\n\/vote forcestart<\/p>\n
# Cancel active voting
\n\/vote cancel<\/p>\n
# Reload configuration
\n\/vote reload<\/p>\n
# Hologram management # Join game service # Party commands ## \ud83d\udd0c API Usage<\/p>\n ### For Developers<\/p>\n “`java \/\/ Check voting state \/\/ Get vote counts \/\/ Access database \/\/ Hologram management ## \ud83c\udfd7\ufe0f Project Structure<\/p>\n “` ## \ud83e\udd1d Contributing<\/p>\n Contributions are welcome! Please follow these guidelines:<\/p>\n 1. Fork the repository ## \ud83d\udcdd License<\/p>\n This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.<\/p>\n ## \ud83d\ude4f Acknowledgments<\/p>\n – PaperMC – High-performance Minecraft server ## \ud83d\udce7 Support<\/p>\n – **Issues**: GitHub Issues ## \ud83d\udd04 Version History<\/p>\n ### v1.1.0 ### v1.0.0 A Minecraft plugin to vote for games and launch the game server with CloudNet.<\/p>\n","protected":false},"featured_media":74747,"template":"","meta":{"_minecraft_slug":"gamevoting","_minecraft_project_id":"Mw6hO5eA","_minecraft_author":"Alex_Tang","_minecraft_license":"MIT","_minecraft_downloads":46,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"gamevoting.zip","_minecraft_size_bytes":38615752,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T21:19:03.561046Z","_minecraft_date_created":"2026-01-31T21:28:53.978901Z","_minecraft_date_modified":"2026-03-02T15:12:31.020162Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/gamevoting","_minecraft_icon_attachment_id":74747,"_minecraft_imported_at":"2026-06-04T08:08:22+00:00","_minecraft_import_hash":"1fcd26dd167194244da9539b373aa529","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,128],"mod_loader":[132,133],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-74746","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-purpur","mod_loader-paper","mod_loader-purpur","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n\/vote holograms create # Create at current location
\n\/vote holograms list # List all holograms
\n\/vote holograms remove
\n\/vote join
\n\/party create # Create a party
\n\/party invite
\n\/party join
\n\/party leave # Leave current party
\n\/party disband # Disband your party
\n“`<\/p>\n
\n\/\/ Get voting session
\nVotingSession session = VotingSession.getInstance();<\/p>\n
\nboolean isVoting = session.isVotingInProgress();
\nboolean isReady = session.isReadyPhaseActive();<\/p>\n
\nMap
\nVoteHistoryRepository repo = DatabaseManager.getInstance()
\n .getVoteHistoryRepository();
\nList
\nHologramManager manager = plugin.getHologramManager();
\nmanager.updateAllDisplays(DisplayState.VOTING_ACTIVE);
\n“`<\/p>\n
\nGameVoting\/
\n\u251c\u2500\u2500 src\/main\/java\/com\/talexck\/gameVoting\/
\n\u2502 \u251c\u2500\u2500 GameVoting.java # Main plugin class
\n\u2502 \u251c\u2500\u2500 commands\/ # Command handlers
\n\u2502 \u2502 \u251c\u2500\u2500 VoteCommand.java # Voting commands
\n\u2502 \u2502 \u2514\u2500\u2500 PartyCommand.java # Party commands
\n\u2502 \u251c\u2500\u2500 config\/ # Configuration management
\n\u2502 \u2502 \u251c\u2500\u2500 GameConfig.java # Game configuration
\n\u2502 \u2502 \u2514\u2500\u2500 ConfigLoader.java # Config loader
\n\u2502 \u251c\u2500\u2500 voting\/ # Voting system
\n\u2502 \u2502 \u2514\u2500\u2500 VotingSession.java # Vote session manager
\n\u2502 \u251c\u2500\u2500 database\/ # Database layer
\n\u2502 \u2502 \u251c\u2500\u2500 DatabaseManager.java # Database connections
\n\u2502 \u2502 \u251c\u2500\u2500 models\/ # Data models
\n\u2502 \u2502 \u2514\u2500\u2500 repositories\/ # Data repositories
\n\u2502 \u251c\u2500\u2500 hologram\/ # Hologram displays
\n\u2502 \u2502 \u251c\u2500\u2500 HologramManager.java # Hologram manager
\n\u2502 \u2502 \u2514\u2500\u2500 HologramDisplayManager.java
\n\u2502 \u251c\u2500\u2500 listeners\/ # Event listeners
\n\u2502 \u2502 \u251c\u2500\u2500 VoteItemListener.java # Vote item interactions
\n\u2502 \u2502 \u251c\u2500\u2500 PlayerJoinListener.java # Player join events
\n\u2502 \u2502 \u2514\u2500\u2500 VotingPlayerQuitListener.java
\n\u2502 \u251c\u2500\u2500 cloudnet\/ # CloudNet integration
\n\u2502 \u2502 \u2514\u2500\u2500 CloudNetAPI.java # CloudNet API wrapper
\n\u2502 \u251c\u2500\u2500 party\/ # Party system
\n\u2502 \u2502 \u2514\u2500\u2500 PartyManager.java # Party management
\n\u2502 \u2514\u2500\u2500 utils\/ # Utility classes
\n\u2502 \u251c\u2500\u2500 item\/VoteItem.java # Vote item management
\n\u2502 \u251c\u2500\u2500 MessageUtil.java # Message utilities
\n\u2502 \u2514\u2500\u2500 ActionBarUtil.java # ActionBar utilities
\n\u251c\u2500\u2500 src\/main\/resources\/
\n\u2502 \u251c\u2500\u2500 plugin.yml # Plugin metadata
\n\u2502 \u251c\u2500\u2500 config.yml # Default config
\n\u2502 \u251c\u2500\u2500 games.yml # Game definitions
\n\u2502 \u2514\u2500\u2500 lang\/ # Language files
\n\u2502 \u251c\u2500\u2500 en-US.yml
\n\u2502 \u251c\u2500\u2500 en-UK.yml
\n\u2502 \u2514\u2500\u2500 zh-CN.yml
\n\u2514\u2500\u2500 pom.xml # Maven configuration
\n“`<\/p>\n
\n2. Create a feature branch (`git checkout -b feature\/amazing-feature`)
\n3. Commit your changes (`git commit -m ‘Add amazing feature’`)
\n4. Push to the branch (`git push origin feature\/amazing-feature`)
\n5. Open a Pull Request<\/p>\n
\n– CloudNet – Minecraft cloud system
\n– DecentHolograms – Hologram API
\n– All contributors and users of this plugin<\/p>\n
\n– **Documentation**: [User Guide](doc\/USER_GUIDE.md)
\n– **Chinese Documentation**: [\u4f7f\u7528\u6587\u6863](doc\/USER_GUIDE_zh.md)<\/p>\n
\n– Added pre-voting ready system with emerald triggers
\n– Implemented post-voting ready phase with dye indicators
\n– Added player count-based item distribution
\n– Enhanced hologram display states
\n– Improved CloudNet integration
\n– Added vote history database tracking
\n– Teleport filtering for voted players only<\/p>\n
\n– Initial release
\n– Basic voting system
\n– CloudNet service integration
\n– Hologram displays
\n– Multi-language support<\/p>\n","protected":false},"excerpt":{"rendered":"