VoteGuard

# VoteGuard

VoteGuard is a Minecraft Forge mod that adds a custom voting and round-based gameplay system. It combines a clear player voting menu with an Imposter-vs-Crew style game mode, making it useful for servers, minigames, events, adventure maps, and roleplay projects.

With VoteGuard, players can vote through an easy-to-use inventory-style menu. Player heads are shown as voting options, and each vote runs with a timer and bossbar. Players can either cast a vote or leave the vote without choosing anyone.

VoteGuard also includes its own game system with roles. When a round starts, players are randomly assigned as either Crewmates or Imposters. Each player receives their role in chat and as an on-screen title. Imposters can eliminate Crewmates, while Crewmates can win by collecting quest points or by eliminating all Imposters.

The mod supports multiple win conditions. The Crew wins when all Imposters are eliminated or when enough quest points are collected. The Imposters win when no Crewmates remain. After a round ends, players are automatically teleported back to a lobby position.

VoteGuard also includes a teleport system for voting results. The voted-out player can be sent to a configured location. Once that player dies, the remaining players can be teleported to another configured location. This makes it possible to create arenas, punishment areas, spectator zones, story sequences, or custom event flows.

Another feature is the camera point system. Server owners can save camera or viewpoint locations. Players can receive a private clickable list of camera points, teleport to one of them, and later return to their previous position. This is useful for observation points, event cameras, cutscene locations, or command block controlled map mechanics.

VoteGuard also includes simple server tools, such as commands for force-loading and unloading chunks. This can help keep important areas active, such as lobbies, arenas, technical rooms, or quest zones.

Many important values can be customized through the config, including vote duration, whether players can vote for themselves, the number of Imposters, kill cooldown, required quest points, and teleport locations.

## Main Features

- Voting system with player heads
- Double-chest style voting interface
- Bossbar timer for active votes
- Players can vote or leave the vote
- Protection against bypassing the vote menu
- Automatic vote result handling
- No random elimination if nobody votes
- Round-based game system with Crewmates and Imposters
- Random role assignment when a round starts
- Role display in chat and as an on-screen title
- Imposters can eliminate Crewmates
- Imposter kill cooldown
- Crewmates cannot deal damage during a round
- Win conditions for Crew and Imposters
- Quest point system for Crew victory
- Automatic lobby teleport after the game ends
- Teleport target for voted-out players
- Teleport target for remaining players after the voted-out player dies
- Camera/viewpoint system
- Private clickable camera list
- Command block compatible camera access
- Return to the previous position after leaving a camera point
- Camera points can be saved and deleted
- Chunk loading commands for important areas
- Configurable game rules and teleport locations

VoteGuard is designed to give server owners and map creators a flexible tool for custom minigames and event systems without requiring custom textures or complicated setup.