starget_docs

Complete documentation for commands, configuration, and permissions

Player Commands

  • /starget join <game> Join a StarGet game
  • /starget leave Leave your current game
  • /starget stats View your personal statistics
  • /starget list List all available games

Admin Commands

Game Management

  • /starget setmainlobby Set the main lobby location
  • /starget create <name> Create a new game arena
  • /starget delete <name> Delete an existing game
  • /starget setlobby <game> Set the lobby location where players wait
  • /starget addspawn <game> <number> Add a spawn point (at your current location)
  • /starget start <game>
  • /starget stop <game> Stop a running game
  • /starget reload Reload configuration and game files

Leaderboard Hologram

  • /starget sethologram Set hologram location at your current position (displays top 10 players)

Configuration

config.yml

# Language (EN or FR)
language: FR

# Default game duration (seconds)
defaultGameDuration: 120

# Default maximum players
defaultMaxPlayers: 15

# Default minimum players to start
defaultMinPlayers: 2

# Default countdown duration (seconds)
defaultCountdownDuration: 30

# Default podium duration (seconds)
defaultPodiumDuration: 30

# Spectator duration after being hit (seconds)
spectatorDuration: 5

games/<game-name>.yml

# Maximum number of players
maxPlayers: 15

# Minimum number of players to start
minPlayers: 2

# Game duration in seconds
gameDuration: 120

# Countdown duration before game starts
countdownDuration: 30

# Podium duration after game ends
podiumDuration: 30

# Spectator duration after being hit
spectatorDuration: 5

# Enable podium system
enablePodium: true

# Lobby location
lobby:
  world: world
  x: 0.0
  y: 64.0
  z: 0.0
  yaw: 0.0
  pitch: 0.0

# Spawn points (add as many as maxPlayers)
spawns:
  1:
    world: world
    x: 10.0
    y: 64.0
    z: 10.0
    yaw: 0.0
    pitch: 0.0
  2:
    world: world
    x: -10.0
    y: 64.0
    z: -10.0
    yaw: 180.0
    pitch: 0.0

Join Signs

Create a sign with the following format (it will auto-format):

Line 1: [StarGet]
Line 2: <game-name>
Line 3: (auto-filled with player count)
Line 4: (auto-filled with game status)

The sign will show real-time player count and game status (WAITING, COUNTDOWN, PLAYING, ENDING)

Statistics System

StarGet tracks player statistics in an SQLite database:

  • Games Played Total number of games participated in
  • Games Won Number of victories
  • Total Stars Cumulative score across all games
  • Highest Score Best single-game performance
  • Win Rate Calculated as (Games Won / Games Played) × 100

Game Phases

1. Lobby Phase

  • Stats book in slot 4
  • Lime bed in slot 8 to leave
  • Waiting for minimum players

2. Countdown Phase

  • Countdown from 30 seconds
  • Titles at key intervals
  • Cancels if below minimum players

3. Playing Phase

  • StarGun in slot 0
  • Live scoreboard updates
  • Spectator system on hit

4. Overtime (if tied)

  • 30 seconds sudden death
  • First to break tie wins
  • Multiple winners if still tied

5. Ending Phase

  • Winner announcement
  • Podium with fireworks
  • Stats saved to database
  • Players return to spawn

Permissions

  • starget.joindefault: true
  • starget.leavedefault: true
  • starget.lobbydefault: true
  • starget.spectatedefault: true
  • starget.admindefault: op
  • starget.*default: op (all permissions)

Troubleshooting

  • ❓ Game won't start Ensure you have set lobby location and added enough spawn points (at least minPlayers spawns)
  • ❓ Players can't shoot Make sure the game is in PLAYING phase, not LOBBY or COUNTDOWN
  • ❓ Stats not saving Check that plugins/StarGet/playerdata.db exists and has write permissions
  • ❓ Hologram not showing Use /starget sethologram to set the location, then /starget reload to refresh