Créer & gérer sa faction
Toutes les commandes /f, grades, permissions fixes et sources de pouvoir (création 65, membres, PvP, banque, events, admin).
Toutes les commandes /f
Sans argument, /f ouvre le menu. Alias principal : /faction.
Gestion & infos
| Commande | Effet | Qui |
|---|---|---|
| /f | Menu de faction | Tous |
| /f help | Liste d'aide en chat | Tous |
| /f create <nom> | Crée la fac, claim le chunk, pose le f-spawn | Hors faction ; zone claimable |
| /f rename <nouveau_nom> | Renomme + régénère le tag (chat/TAB/nametag/Discord) | Chef · alias /f name, /f renommer |
| /f info [nom] | Tag, chef, membres, claims, pouvoir, claims max | Tous |
| /f list | Liste des factions | Tous |
| /f members | Membres + rang + online | Membre |
| /f join … | Message : il faut être invité (pas de join libre) | Tous |
| /f perms [grade] | Permissions fixes du grade | Membre |
| /f disband | Dissolution définitive | Chef |
Membres
| Commande | Effet | Qui |
|---|---|---|
| /f invite <pseudo> | Invitation 5 min (cible online) | FACCEPT (Officier+) ou chef |
| /f accept | Rejoint en Recrue | Invité |
| /f deny | Refuse l'invitation | Invité · alias /f refuse |
| /f leave | Quitte (−5 pouvoir). Chef seul → destruction ; chef avec membres → bloqué | Membre |
| /f kick <pseudo> | Expulse (−5). Pas le chef ; pas rang ≥ soi | FKICK (Officier+) ou chef |
| /f ban <pseudo> | Kick équivalent (liste ban non persistée) | BAN (Officier+) ou chef |
| /f promote <pseudo> | Recrue→Membre→Vétéran→Officier | Chef · alias /f promo |
| /f demote <pseudo> | Officier→Vétéran→Membre→Recrue | Chef · alias /f demo |
Territoire & mobilité
| Commande | Effet | Qui / notes |
|---|---|---|
| /f claim | Claim chunk actuel | ADD_CLAIMS (Membre+) · quota · contigu · distance 2 |
| /f unclaim | Unclaim si claim de ta fac | REMOVE_CLAIMS (Officier+) |
| /f autoclaim on|off | Claim auto en wilderness | ADD_CLAIMS |
| /f map | GUI inventaire 9×5 : claim/unclaim au clic (gris/vert), couleurs diplomatie | Sans cooldown |
| /f map chat | Ancienne grille chat 11×11 (+ # @ X = P -) | Cooldown 30 s |
| /f secret | Cache claims/spawn 1 h | SECRET (Officier+) · CD 24 h |
| /f spawn | TP f-spawn | Cooldown global 30 s · warmup 3 s |
| /f go | Même TP f-spawn (même cooldown 30 s) | Membre |
| /f setspawn | Pose f-spawn (dans un claim) | Chef |
| /f warp [nom] | Liste / TP warp de fac | FWARP (Membre+) · CD 30 s |
| /f setwarp <nom> | Crée warp (dans un claim) | FWARP · quota warps |
| /f delwarp <nom> | Supprime un warp | FWARP |
Banque & chat
| Commande | Effet | Qui |
|---|---|---|
| /f bank | Ouvre la GUI banque (dépôt / retrait / pouvoir / historique) | INFO_BANK / BANK_ADD / chef |
| /f bank add|deposit <n> | Dépose Cantox perso → banque | BANK_ADD (Recrue+) ou chef |
| /f bank take|withdraw <n> | Retire banque → perso | BANK_TAKE (Officier+) ou chef |
| /f power | GUI pouvoir : quotas, paliers, achat | Membres (achat : chef/officier) |
| /f bank power | Même GUI pouvoir | Membres (achat : chef/officier) |
| /f bank power <n> | Achète n unités (+10 pouvoir/unité) en chat (1–50) | Chef, Officier, ou BANK_TAKE |
| /f c [msg] | Toggle chat fac ou envoi direct | Membre |
| /fc [msg] | Raccourci chat fac | Membre |
/f disbandDissout la faction (claims retirés, rôles Discord sync).
Alias : /f delete, /f supprimer
/f perms [grade]Affiche les permissions du grade (fixes, non configurables).
Alias : /f permissions
Création
- Impossible si déjà en faction, nom invalide / déjà pris, zone protégée (spawn/warp), ou chunk déjà claim.
- Nom : 3–16 caractères, lettres (accents OK), chiffres, _ et - (pas d'espaces) — mêmes règles pour /f rename et /admin f rename.
- Tag auto : 4 premiers caractères du nom (majuscules), suffixe numérique si collision.
- Effets immédiats : claim du chunk actuel + f-spawn à ta position + annonce Discord si salon configuré.
- config factions.min-members-create (8) est lu mais non vérifié à la création (TODO dans le code).
Renommer
- Chef : /f rename <nouveau_nom> (alias /f name, /f renommer).
- Staff : /admin f rename <faction> <nouveau_nom>.
- Met à jour le nom et régénère le tag ; rafraîchit les préfixes (chat / TAB / nametag) des membres en ligne ; renomme le rôle Discord dédié s'il existe.
Grades & permissions
Permissions fixes par grade (FactionPermissions). Le chef bypass tout. Le Vétéran n'a pas d'entrée dans la table → aucune permission de cette liste.
- Promouvoir : Recrue → Membre → Vétéran → Officier (chef seul).
- CULTURES (fermes publiques) : activé seulement si Recrue a CULTURES — ce n'est pas le cas → récolte publique off.
- Alliés (diplomatie) : build / portes comme membres ; conteneurs (coffres…) réservés aux membres + grade Chèvre (vol). Pose de stockage toujours réservée au claim de sa propre fac.
Qui peut quoi
| Permission | Recrue | Membre | Vétéran | Officier | Chef |
|---|---|---|---|---|---|
| BANK_ADD (déposer) | oui | oui | — | oui | oui |
| ADD_CLAIMS / autoclaim | — | oui | — | oui | oui |
| INFO_BANK (voir banque) | — | oui | — | oui | oui |
| FWARP (warps) | — | oui | — | oui | oui |
| REMOVE_CLAIMS | — | — | — | oui | oui |
| FACCEPT (inviter) | — | — | — | oui | oui |
| FKICK / BAN / UNBAN | — | — | — | oui | oui |
| BANK_TAKE / power buy | — | — | — | oui | oui |
| SECRET | — | — | — | oui | oui |
| SET_PERMS / CULTURES (flags) | — | — | — | — | oui |
Sources de pouvoir
- Exemple fac neuve (pouvoir 65) : claims max 6, warps 1, hoppers 3.
- PowerManager (gains/pertes quotidiens) existe mais n'est pas branché → pas une source active.
Gains / pertes
| Source | Δ pouvoir | Détail code |
|---|---|---|
| Création | +65 | BASE 60 + POWER_PER_MEMBER 5 (chef) |
| Join membre | +5 | FactionManager#addMember |
| Leave / kick | −5 | Plancher 0 + retrait claims hors quota (plus récents d'abord) |
| Kill PvP | +5 tueur / −5 victime | PlayerListener (si les deux ont une fac) |
| Event faction top 5 | +50 / +35 / +25 / +15 / +10 | events.yml → FactionEventManager |
| /f bank power | +10 pouvoir / unité achetée | Débit banque ; power_purchased += unités |
| /f power | — | GUI quotas + paliers + achat |
| /admin addpower <fac> <n> | +n | Staff |
| /admin f rename <fac> <nom> | — | Staff : renomme + tag |
Quotas dérivés du pouvoir
| Quota | Formule |
|---|---|
| Claims max | max(5, pouvoir / 10) — division entière |
| Warps de fac | si pouvoir < 60 → 1 ; sinon 1 + (pouvoir − 60) / 30 |
| Hoppers posables (claims de la fac) | max(0, pouvoir / 20) — config `factions.hopper-limit` (divisor 20, min 0) |
Achat banque — config actuelle
| Paramètre | Valeur |
|---|---|
| Formule prix | cost(i) = floor(base × growth^(i × 10)) · i = power_purchased (unités) |
| power-per-unit | 10 — Acheter 1 → +10 pouvoir ; n → +10×n |
| base | 5 000 Cantox |
| growth | 1,18 |
| max-per-purchase | 1 à 50 unités |
| 1re unité (i=0) | 5 000 Cantox → +10 pouvoir |
| 2e unité (i=1) | floor(5000 × 1,18^10) ≈ 26 168 Cantox → +10 pouvoir |
/f powerGUI : pouvoir actuel, formules claims/warps/hoppers, paliers suivants, achat 1/2/3/5/max unités (1 → +10 pouvoir).
Tous les membres voient l'info ; achat réservé officiers / chef (ou BANK_TAKE). Alias : /f pouvoir
/f bank powerOuvre la même GUI pouvoir. Aussi accessible depuis /f et /f bank.
/f bank power <nombre>Achète n unités en chat (+10 pouvoir/unité). Officiers / chef (ou BANK_TAKE). Max 50.
/admin addpower <faction> <montant>Ajoute du pouvoir à une faction.
Staff
/admin f rename <faction> <nouveau_nom>Renomme une faction, régénère le tag, rafraîchit les nametags en ligne et le rôle Discord.
Staff (op) · alias sous-commande : renommer