starget_docs

Documentation complète des commandes, configuration et permissions

Commandes Joueur

  • /starget join <game> Rejoindre une partie StarGet
  • /starget leave Quitter votre partie actuelle
  • /starget stats Voir vos statistiques personnelles
  • /starget list Lister toutes les parties disponibles

Commandes Admin

Gestion des Parties

  • /starget setmainlobby Définir l'emplacement du lobby principal
  • /starget create <name> Créer une nouvelle arène de jeu
  • /starget delete <name> Supprimer un jeu existant
  • /starget setlobby <game> Définir l'emplacement du lobby où les joueurs attendent
  • /starget addspawn <game> <number> Ajouter un point d'apparition (à votre position actuelle)
  • /starget start <game>
  • /starget stop <game> Arrêter une partie en cours
  • /starget reload Recharger la configuration et les fichiers de jeu

Hologramme du Classement

  • /starget sethologram Définir l'emplacement de l'hologramme à votre position (affiche les 10 meilleurs joueurs)

Configuration

config.yml

# Langue (EN ou FR)
language: FR

# Durée de partie par défaut (secondes)
defaultGameDuration: 120

# Nombre maximum de joueurs par défaut
defaultMaxPlayers: 15

# Nombre minimum de joueurs pour démarrer
defaultMinPlayers: 2

# Durée du compte à rebours par défaut (secondes)
defaultCountdownDuration: 30

# Durée du podium par défaut (secondes)
defaultPodiumDuration: 30

# Durée spectateur après avoir été touché (secondes)
spectatorDuration: 5

games/<game-name>.yml

# Nombre maximum de joueurs
maxPlayers: 15

# Nombre minimum de joueurs pour démarrer
minPlayers: 2

# Durée de partie en secondes
gameDuration: 120

# Durée du compte à rebours avant le début
countdownDuration: 30

# Durée du podium après la fin
podiumDuration: 30

# Durée spectateur après avoir été touché
spectatorDuration: 5

# Activer le système de podium
enablePodium: true

# Emplacement du lobby
lobby:
  world: world
  x: 0.0
  y: 64.0
  z: 0.0
  yaw: 0.0
  pitch: 0.0

# Points d'apparition (autant que 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

Panneaux de Rejoin

Créez un panneau avec le format suivant (il se formatera automatiquement) :

Ligne 1: [StarGet]
Ligne 2: <nom-du-jeu>
Ligne 3: (auto-rempli avec le nombre de joueurs)
Ligne 4: (auto-rempli avec le statut de la partie)

Le panneau affichera le nombre de joueurs en temps réel et le statut de la partie (EN_ATTENTE, COMPTE_A_REBOURS, EN_COURS, FIN)

Système de Statistiques

StarGet suit les statistiques des joueurs dans une base de données SQLite :

  • Parties Jouées Nombre total de parties auxquelles vous avez participé
  • Parties Gagnées Nombre de victoires
  • Étoiles Totales Score cumulé dans toutes les parties
  • Meilleur Score Meilleure performance en une seule partie
  • Taux de Victoire Calculé comme (Parties Gagnées / Parties Jouées) × 100

Phases de Jeu

1. Phase de Lobby

  • Livre de stats dans le slot 4
  • Lit vert dans le slot 8 pour partir
  • En attente du minimum de joueurs

2. Phase de Compte à Rebours

  • Compte à rebours de 30 secondes
  • Titres aux intervalles clés
  • Annule si en dessous du minimum

3. Phase de Jeu

  • StarGun dans le slot 0
  • Mises à jour du tableau de score
  • Système spectateur lors d'une frappe

4. Prolongation (si égalité)

  • 30 secondes de mort subite
  • Le premier à briser l'égalité gagne
  • Plusieurs gagnants si toujours égalité

5. Phase de Fin

  • Annonce du gagnant
  • Podium avec feux d'artifice
  • Stats sauvegardées dans la BDD
  • Retour des joueurs au spawn

Permissions

  • starget.joinpar défaut : true
  • starget.leavepar défaut : true
  • starget.lobbypar défaut : true
  • starget.spectatepar défaut : true
  • starget.adminpar défaut : op
  • starget.*par défaut : op (toutes les permissions)

Dépannage

  • ❓ La partie ne démarre pas Assurez-vous d'avoir défini l'emplacement du lobby et ajouté assez de points d'apparition (au moins minPlayers spawns)
  • ❓ Les joueurs ne peuvent pas tirer Assurez-vous que la partie est en phase PLAYING, pas LOBBY ou COUNTDOWN
  • ❓ Les stats ne se sauvegardent pas Vérifiez que plugins/StarGet/playerdata.db existe et a les permissions d'écriture
  • ❓ L'hologramme ne s'affiche pas Utilisez /starget sethologram pour définir l'emplacement, puis /starget reload pour rafraîchir