Open Weapons
open-weapons
Armi da fuoco e melee, munizioni, accessori, armature e tutto il gameplay RP collegato al combat: rapine, perquisizioni, arresti, wanted e radio delle forze dell'ordine.
Open source · Apache 2.0 · Paper 1.21.x
La suite open source per server Minecraft roleplay.
Open Roleplay è una raccolta di moduli Paper indipendenti — armi, accessi, cosmetici, distributori e un core condiviso. Usali insieme o uno alla volta. Leggibili, modificabili e tuoi.
// È gratuito, e lo sarà per sempre.
// Recupera un modulo dal services manager
OpenWeaponsApi api = getServer()
.getServicesManager()
.load(OpenWeaponsApi.class);
// Sostituisci un adapter a runtime
api.adapters().setNotification(myDiscordRelay);
// Osserva o veta il combat
@EventHandler
public void onHit(WeaponHitEvent e) {
if (safezone(e)) e.setCancelled(true);
}
Adapter-first
API pubblica
6moduli Paper
100%open source
Apache 2.0licenza del codice
∞gratis per sempre
La filosofia
Open, perché è trasparente.
Open, perché è trasparente.
Roleplay, perché è la modalità che amiamo.
Open Roleplay nasce da un'idea semplice: il software che fa girare il tuo server dovrebbe essere leggibile, modificabile e tuo. Niente scatole nere, niente lock-in.
È gratuito, e lo sarà per sempre.
Trovi un bug? Prendi il codice e sistemalo.
Non ti piace qualcosa? Modificalo.
Vuoi adattarlo o ampliarlo per il tuo server? Sei libero di farlo.
I moduli
Sei moduli, una sola famiglia
Ogni modulo è un plugin Paper autonomo con default funzionanti. Quando si trovano sullo stesso server, si riconoscono e collaborano — senza dipendenze obbligatorie.
Snapshot
Open Access
open-access
Controllo accessi a regioni WorldGuard e blocchi sensibili: casse, porte, container e macchine. Profili, trust, ruoli e preset, con storage SQLite o MySQL.
Open Cosmetics
open-cosmetics
Cosmetici arma senza duplicare la logica del combat: LED, colori custom, skin con suoni dedicati, gettoni consumabili, editor, banco e stazioni nel mondo.
Open Vending Machines
open-vending-machines
Distributori automatici roleplay realistici, rifornibili e assegnabili ad aziende. Adapter-first: porti la tua economy, il tuo inventario e le tue aziende senza fork.
Open Core
open-core-paper
Il plugin di base. Nessun gameplay: espone un servizio Bukkit, un lifecycle ordinato dei moduli, database opzionale SQLite/MySQL, HUD e invio del resource pack.
Open Core API
open-core-api
I contratti pubblici minimi condivisi dai moduli: lifecycle, accesso opzionale al database, messaggi, permessi, stato HUD e utility item. Tipi stabili, zero gameplay.
Come è fatta
Adapter-first, per scelta
Il core non importa mai direttamente la tua economy, il tuo plugin inventario o il tuo sistema aziende. Ogni sistema esterno passa da una piccola interfaccia — un adapter — con un default già funzionante e sostituibile a runtime dal tuo plugin.
- Installa e funziona: ogni modulo parte con default sensati, senza servizi proprietari.
- Eventi Bukkit: osserva o veta le azioni con un comune
@EventHandler. - Degrada con eleganza: se un modulo opzionale non c'è, la feature si disattiva chiaramente senza bloccare l'avvio.
- Niente fork: colleghi i tuoi sistemi sostituendo un adapter, non riscrivendo il plugin.
open-core-api
contratti pubblici condivisi · Bukkit Services
contratti pubblici condivisi · Bukkit Services
Open Corelifecycle + DB
Open Accessaccessi RP
Open Weaponscombat + RP
Open Cosmeticscosmetici arma
Open Vending Machineseconomy / inventario / aziende via adapter
Perché Open Roleplay
Pensato per chi gestisce un server
Davvero open
Codice sotto Apache 2.0: leggilo, modificalo, adattalo. Niente offuscamento, niente componenti chiusi.
Modulare
Sei plugin separati. Installa solo ciò che ti serve: ognuno è leggibile e compilabile da solo.
Integrabile
API pubbliche via Bukkit Services, eventi cancellabili e adapter sostituibili: collega i tuoi sistemi senza fork.
Sicuro lato server
Logica critica server-side, transazioni atomiche e lock per-risorsa: il client non viene mai fidato.
Bilingue IT / EN
Messaggi in italiano e inglese, selezionati in automatico dalla lingua del client. Tutto personalizzabile.
Resource pack aperti
Asset in formato aperto con pack.mcmeta e assets/: esplorali, modificali e ricomprimili senza strumenti proprietari.
Installazione
Da zero al server in pochi passi
Requisiti: Java 21, Maven 3.9+, Paper 1.21.x e Git. WorldGuard/WorldEdit servono per Open Access.
Clona la repository
Tutti i moduli vivono in un parent Maven multi-modulo.
Compila i moduli
Una build completa produce i jar e gli zip dei resource pack.
Installa su Paper
Metti il jar del modulo desiderato nella cartella plugins/ del server.
Avvia e configura
Al primo avvio vengono generati i file di config; modificali e ricarica con il comando del modulo.
bash · build completa
git clone https://github.com/giovyx90/open-roleplay.git
cd open-roleplay
mvn -B -ntp clean packagebash · solo un modulo
mvn -B -ntp package -pl open-vending-machines -am
# il jar finisce in: open-vending-machines/target/
Download
Scarica i moduli
I JAR pronti all'uso sono pubblicati nelle Release di GitHub. Preferisci compilare? Trovi il sorgente di ogni modulo nel monorepo.
Open Weapons
open-weapons
Open Access
open-access
Open Cosmetics
open-cosmetics
Open Vending Machines
open-vending-machines
Open Core
open-core-paper
Open Core API
open-core-api