Documentation SocialSystem

Requisiti#

• Un proxy Velocity oppure BungeeCord
• Uno o più server Paper 1.21+ (Java 21)
• Un database MySQL/MariaDB raggiungibile dal proxy
• (Opzionale) PlaceholderAPI sui backend, per livello/clan nella GUI amici

Installazione#

1. Database#

Crea database e utente (le tabelle si creano da sole al primo avvio):

CREATE DATABASE social_system CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'social_user'@'%' IDENTIFIED BY 'PASSWORD_FORTE';
GRANT ALL PRIVILEGES ON social_system.* TO 'social_user'@'%';
FLUSH PRIVILEGES;

2. Proxy#

1. Metti SocialSystem-Velocity.jar oppure SocialSystem-Bungee.jar nella cartella plugins/ del proxy (solo uno, quello del tuo proxy).
2. Avvia una volta: genera plugins/socialsystem/config.yml e language.yml.
3. Compila la sezione mysql e riavvia.

3. Server Paper (ognuno)#

1. Metti SocialSystem-Paper.jar in plugins/ di ogni server backend.
2. Avvia: genera config.yml (dimensioni GUI) e language.yml.
3. Assicurati che il forwarding dei plugin message sia attivo:
   • Velocity: modern forwarding (default) va bene.
   • BungeeCord: ip_forward: true in config.yml.

Il canale di comunicazione socialsystem:main viene registrato in automatico.

Configurazione#

Proxy — plugins/socialsystem/config.yml#

mysql:
  host: "127.0.0.1"
  port: 3306
  database: "social_system"
  username: "social_user"
  password: "CAMBIAMI"
  properties: "useSSL=false&autoReconnect=true&characterEncoding=utf8"
  pool-size: 6

party:
  default-privacy: "private"   # "private" (serve invito) o "public"
  max-size: 8

friend:
  max-friends: 100
  notify-on-login: true        # avvisa gli amici online quando uno entra

Backend Paper — config.yml#

party:
  max-size: 8      # deve combaciare col proxy (usato solo per la GUI)
  gui-size: 27

friend:
  gui-size: 54
  level-placeholder: ""   # es. "%tuoplugin_livello%" (richiede PlaceholderAPI)
  clan-placeholder: ""    # es. "%tuoplugin_clan%"

Testi — language.yml#

Presente sia sul proxy sia sui backend.

• I messaggi ai giocatori (esiti comandi, notifiche) li invia il proxy: modificali lì.
• I testi delle GUI (titoli, bottoni, lore) li legge il backend.

Tienili allineati. Supporta i codici colore &.

Comandi#

I comandi sono registrati sul proxy e valgono su tutta la network.

Party — /party (alias /p)#