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 indipendenti per server Paper — lavori base con Open Jobs, politica con Open Politics, aziende, FDO, crime, armi, accessi, cosmetici, distributori, gestionale, core e API condivisa. Usali insieme o uno alla volta. Leggibili, modificabili e tuoi.
// È gratuito, e lo sarà per sempre.
// Recupera Open Jobs dal services manager
OpenJobsApi api = getServer()
.getServicesManager()
.load(OpenJobsApi.class);
// Collega la tua economy senza fork
api.adapters().setEconomy(myEconomyBridge);
// Leggi sessione e tier per dashboard/licenze
api.getActiveSession(playerId).ifPresent(session -> {
api.getTier(playerId, session.jobId());
});
Adapter-first
API pubblica
12moduli pubblici
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.
Non è un server roleplay pronto all'uso: è la base su cui costruire il tuo. Ti diamo le fondamenta — lifecycle, dati, aziende, lavori, FDO, crime, accessi — e una configurazione di riferimento; il mondo che i giocatori vedranno lo costruisci tu sopra, in config e via adapter, senza fork. Leggi la filosofia.
È 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
Dodici moduli, una sola famiglia
Ogni modulo pubblicabile ha default funzionanti. Quando i plugin Paper 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 Companies
open-companies
Aziende roleplay, camera di commercio, asset fisici, treasury, ledger, cash, carte e paghe ricorrenti. Adapter-first: economy, storage, permessi, regioni e audit sono sostituibili.
Open FDO
open-fdo
Il sistema nervoso dello stato roleplay, neutro rispetto all'ambientazione: corpi, gradi e capability da config, atti depositati come libri timbrati, fascicoli con catena di custodia delle prove, ricercati e detenzione via adapter.
Open Crime
open-crime
Il sottobosco criminale roleplay, adapter-first e neutro: organizzazioni, territorio, produzione multistadio, traffico, riciclaggio ed estorsione. RP First: niente heat, le autorità scoprono solo via denunce, arresti e informatori.
Open Jobs
open-jobs
I lavori base roleplay, adapter-first e neutri: sessioni fisiche, location, licenze professionali, progressione per anzianità e tre modelli di paga. RP First: paga l'attività reale, non il tempo.
Open Politics
open-politics
Il motore politico roleplay, adapter-first e neutro: cariche, governi, elezioni, atti firmati e registro pubblico delle leggi. RP First: il plugin certifica, non governa.
Open Gestionale
open-gestionale
Gestionale web universale: API bridge Node.js + frontend React. Carica il layout dall'API e renderizza widget adapter-first, inclusi quelli per Open Jobs.
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
Open Companiesaziende / licenze / treasury / asset
Open FDOautorità / atti / fascicoli / detenzione via adapter
Open Crimeorganizzazioni / traffico / discovery RP
Open Jobslavori base / sessioni / paghe via adapter
Open Politicscariche / governi / leggi / elezioni
Open GestionaleAPI bridge / dashboard / demo live
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
Dodici moduli 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.
Changelog
Ultime novità del progetto
Le modifiche più recenti ora sono tracciate direttamente nel sito, inclusi Open Politics, Open Jobs, Open Crime, Open Gestionale e le rifiniture mobile già pubblicate.
18 giu
2026
Open Politics: il motore politico RP
open-politics: cariche, governi, elezioni, atti firmati e registro pubblico delle leggi
Open Politics entra nella suite come motore politico adapter-first e neutro rispetto all'ambientazione. Il primitivo è una carica con un titolare, un governo che la assegna, un atto firmato che diventa legge. RP First: il plugin certifica chi aveva l'autorità di decidere ed espone la decisione — non esegue mai le sue conseguenze, le vivono i giocatori.
- Quattro meccanismi di assegnazione delle cariche (elezione, nomina, ereditarietà, conquista) e organi collegiali con voto interno a quorum.
- Iter legislativo tracciato (proposta → voto → veto → promulgazione) e registro pubblico delle leggi con archivio storico per i giudici RP.
- Economia, aziende, identità, regioni e autorità passano da adapter opzionali; espone
OpenPoliticsApiche Open FDO aggancia ai fascicoli.
17 giu
2026
Open Jobs: i lavori base RP
open-jobs: sessioni di lavoro fisiche, licenze, progressione e tre modelli di paga
Open Jobs entra nella suite come motore dei lavori base adapter-first e neutro rispetto all'ambientazione. Il primitivo è un'attività fisica accessibile a chiunque — vai, lavori, guadagni — senza assunzioni né aziende. RP First: paga l'attività realmente svolta nella sessione, non i minuti trascorsi nella region.
- Tre modelli di paga (a produzione, a sessione, a consegna) più lavori trasformativi pagati per crafting su banco.
- Progressione per anzianità basata su sessioni reali nel tempo (niente XP), con decadimento opzionale e licenze professionali revocabili.
- Economia, aziende, identità e regioni passano da adapter opzionali; espone
OpenJobsApie widget per Open Gestionale.
17 giu
2026
Open Crime: il sottobosco criminale RP
open-crime: organizzazioni, produzione, traffico, riciclaggio ed estorsione
Open Crime entra nella suite come modulo Paper adapter-first e neutro rispetto all'ambientazione. Gestisce organizzazioni illegali, gerarchie, territori e filiere criminali senza telemetrie nascoste o scorciatoie fuori RP.
- Cinque sottosistemi attivabili da config: syndicate, production, traffic, laundering e racket.
- RP First: niente "heat" automatico; le autorità scoprono solo tramite denunce, arresti, prove fisiche, informatori o indagini.
- Economia, aziende e autorità passano da adapter opzionali; espone
OpenCrimeApiper integrazioni esterne.
17 giu
2026
Open Gestionale: il gestionale web adapter-first
open-gestionale: API bridge Node.js + frontend React, con demo navigabile
Un gestionale web universale che non conosce l'ambientazione: carica il layout dall'API e renderizza widget modulari. Cosa mostrano lo decide la config — gli esempi realistico-it e fantasy girano sullo stesso identico codice.
- Widget gated per modulo e capability sia nel layout sia negli endpoint; un modulo assente degrada in "non disponibile" invece di rompersi.
- Autenticazione senza password: OTP generato in gioco + JWT che porta solo l'UUID, così i permessi si rileggono dal DB a ogni richiesta.
- Demo live su
demo.openroleplay.itcon dati fittizi (5 profili, nessun login), Docker Compose in un comando, OpenAPI 3.0 e test di parità demo↔SQLite.
17 giu
2026
Open FDO pubblicato come modulo autorità
open-fdo: il sistema nervoso dello stato, adapter-first e neutro
Un modulo che non conosce ambientazioni: corpi, gradi, capability, atti, reati e livelli ricercato vivono tutti nella config. Gli atti si depositano scrivendo e firmando un libro che il plugin timbra; i fascicoli tracciano capi d'imputazione, prove con catena di custodia e sentenze.
- Capability ereditate per grado; gli atti compaiono solo se il grado e l'eventuale adapter sono presenti.
- Detenzione, audit economico, referti esterni, radio e tracce sono adapter opzionali: assenti, la capability sparisce in silenzio.
- Espone
OpenFdoApi; sito con pagina dedicata, download e changelog aggiornati.
17 giu
2026
Open Companies aggiunge treasury e banking diegetico
open-companies: ledger, cash, carte e payroll
La nuova economia aziendale usa tesorerie lockate, ledger append-only, banconote fisiche, carte pagamento, asset registrabili in-world e stipendi ricorrenti dai terminali aziendali.
TreasuryServiceeBankingServiceespongono movimenti atomici via API pubblica.- Storage YAML/memoria ora salva transazioni e paghe ricorrenti oltre ad aziende, richieste e asset.
- I comandi admin possono consegnare cash e carte; gli asset si registrano guardando il blocco.
16 giu
2026
Open Companies pubblicato come settimo modulo
open-companies: aziende, licenze e asset
Il sito presenta ora Open Companies con pagina dedicata, download, API pubblica, comandi e integrazione opzionale con Open Vending Machines.
16 giu
2026
Changelog pubblico in homepage
site: expose recent changes
La home include una nuova sezione changelog, linkata da nav, menu mobile e footer, così le novità del progetto restano visibili senza passare da GitHub.
15 giu
2026
Esperienza mobile rifinita
fix: improve mobile responsiveness
Layout e navigazione sono stati ripuliti per schermi stretti: header più compatto, menu mobile scrollabile, call to action a larghezza piena e griglie che non forzano overflow laterali.
- Hero, statistiche, moduli, download e pagine dettaglio si adattano meglio sotto i 720px.
- Badge, titoli lunghi, ID dei moduli e blocchi codice gestiscono il wrapping senza uscire dai contenitori.
- Le card dei moduli e i pulsanti mantengono dimensioni leggibili anche su viewport molto piccoli.
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-jobs -am
# il jar finisce in: open-jobs/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 Companies
open-companies
Open FDO
open-fdo
Open Crime
open-crime
Open Jobs
open-jobs
Open Politics
open-politics
Open Core
open-core-paper
Open Core API
open-core-api