ENGLISH

OniriaEconomy

A complete premium economy, shop and rank system for NeoForge 21.1.231 servers.

OniriaEconomy adds a fully integrated virtual currency system based on OniriaCoins (OCS), with an in-game shop, premium rank handling, NPC rewards, chunk purchases, admin management tools and secure PayPal support.

It is designed for servers that want a clean and modern way to sell in-game rewards while keeping full control over purchases, renewals, limits and player progression.

Main Features

Virtual Currency: OniriaCoins (OCS)

Dedicated server currency system
Player balance synchronization between server and client
Admin tools to add or remove currency
Built for server monetization and premium rewards

In-Game Shop

Players can spend OCS directly in a visual in-game shop to buy:

Items
Commands
Temporary or permanent ranks
Chunk claims
NPC presets

The shop includes:

modern UI
purchase confirmation screen
per-entry descriptions
support for limited and unique purchases

Purchase Limits and Unique Purchases

For items, commands and NPC rewards, you can configure:

unique purchase (buy only once)
maximum purchases per player
admin reset of player purchase limits

This is useful for donor kits, one-time unlocks, special rewards and controlled server offers.

Temporary Ranks and Auto Renewal

OniriaEconomy supports rank packages with durations, for example:

7 days
30 days
90 days
permanent ranks

Additional rank features:

automatic expiration handling
optional auto-renewal with OCS
player-side renewal toggle
notifications when a rank is renewed or expires
active temporary ranks cannot be repurchased until they expire

PayPal Integration

Buy OCS through PayPal
sandbox and live modes
server-side verification only
orders are captured securely before currency is credited
transaction logging included
credentials can be stored securely outside the main config

Admin GUI

The admin interface allows you to:

reload the shop config
open the visual shop editor
manage player balances
reset unique / limited purchases for a player

Visual Shop Editor

The built-in editor allows admins to configure the shop without manually editing JSON.
You can create and manage:

PayPal OCS packages
item entries
command entries
rank entries
chunk entries
NPC entries
descriptions
purchase limits
unique purchase flags

Easy NPC Support

OniriaEconomy can reward players with Easy NPC presets.
It supports importing presets directly at the player's location and can automatically apply ownership / follow behavior depending on your setup.

NPC Follow Wand

The mod includes a craftable utility item:

NPC Follow Wand
right-click your owned Easy NPC to toggle follow owner on or off

Chunk Purchase Support

Compatible with command-based chunk reward setups such as FTB Chunks.
You can configure chunk purchase templates and sell claim-related rewards through the shop.

Bought Item Protection

Purchased shop items can be marked as protected so they are not freely stolen through death-related systems, with dedicated logic for Corpse-style gameplay.

Structured Logging

Important actions are logged in a structured format, making moderation and Discord/server monitoring much easier.
Examples include:

purchases
rank renewal toggles
balance modifications
purchase resets
shop config actions

Server Integrations

OniriaEconomy is designed to work especially well with:

NeoForge 1.21.1
FTBRanks
FTB Chunks
Easy NPC
Corpse
PayPal

Some integrations are command-template based, which gives you more freedom to adapt the mod to your server environment.

Security

OniriaEconomy was designed with server-side safety in mind:

PayPal validation is done on the server
currency is credited only after payment capture
credentials are not exposed to clients
secure external secret storage is supported
transaction logs are available for audit and support

Typical Use Cases

This mod is ideal for:

donor / premium stores
VIP rank subscriptions
one-time premium kits
paid chunk claims
paid NPC unlocks
custom monetized command rewards
roleplay or survival servers with premium progression

Requirements

Minecraft 1.21.1
NeoForge 21.1.231
Java 21

Notes

Designed primarily for multiplayer server use
Some advanced features depend on your server command templates or optional mods
PayPal is optional if you only want to manage OCS manually

FRANÇAIS

OniriaEconomy

Un système complet d'économie premium, boutique et ranks pour serveurs NeoForge 21.1.231.

OniriaEconomy ajoute une monnaie virtuelle appelée OniriaCoins (OCS) avec une boutique en jeu, des ranks temporaires ou permanents, des récompenses NPC, des achats de chunks, des outils d'administration et un support sécurisé de PayPal.

Le mod est pensé pour les serveurs qui veulent proposer une boutique premium propre, moderne et totalement intégrée en jeu, tout en gardant un contrôle précis sur les achats, les renouvellements, les limitations et la progression des joueurs.

Fonctionnalités principales

Monnaie virtuelle : OniriaCoins (OCS)

système de monnaie dédié au serveur
synchronisation du solde entre serveur et client
outils admin pour ajouter ou retirer des OCS
pensé pour la monétisation serveur et les récompenses premium

Boutique en jeu

Les joueurs peuvent dépenser leurs OCS dans une boutique visuelle pour acheter :

des items
des commandes
des ranks temporaires ou permanents
des chunks
des presets NPC

La boutique comprend :

une interface moderne
un écran de confirmation d'achat
des descriptions par article
des limites d'achat et achats uniques

Limites d'achat et achats uniques

Pour les items, commandes et récompenses NPC, tu peux définir :

un achat unique (une seule fois)
une quantité maximale par joueur
un reset admin des achats limités / uniques d'un joueur

C'est idéal pour les kits premium, les récompenses spéciales, les déblocages uniques et les offres limitées.

Ranks temporaires et renouvellement automatique

OniriaEconomy gère les ranks avec durée, par exemple :

7 jours
30 jours
90 jours
ou permanent

Fonctionnalités associées :

retrait automatique à expiration
renouvellement automatique optionnel avec les OCS
activation/désactivation du renouvellement côté joueur
notifications lors du renouvellement ou de l'expiration
un rank temporaire actif ne peut pas être racheté tant qu'il n'est pas expiré

Intégration PayPal

achat d'OCS via PayPal
mode sandbox et live
vérification uniquement côté serveur
les OCS sont crédités uniquement après capture confirmée du paiement
journalisation des transactions
stockage sécurisé des identifiants en dehors de la config principale

Interface admin

L'interface d'administration permet de :

recharger la config du shop
ouvrir l'éditeur visuel
gérer les soldes des joueurs
reset les achats uniques / limités d'un joueur

Éditeur visuel du shop

L'éditeur intégré permet de configurer la boutique sans modifier manuellement le JSON.
Tu peux y créer et gérer :

les packs OCS PayPal
les articles item
les articles commande
les articles rank
les articles chunk
les articles NPC
les descriptions
les limites d'achat
les achats uniques

Support Easy NPC

OniriaEconomy peut récompenser les joueurs avec des presets Easy NPC.
Le mod peut importer les presets directement à la position du joueur et appliquer automatiquement l'ownership / follow selon ta configuration.

Baguette de suivi NPC

Le mod ajoute aussi un item utilitaire craftable :

NPC Follow Wand
clic droit sur ton Easy NPC pour activer ou désactiver le follow owner

Support des achats de chunks

Compatible avec les systèmes basés sur commandes comme FTB Chunks.
Tu peux vendre des récompenses liées aux claims directement dans la boutique.

Protection des items achetés

Les items achetés peuvent être marqués comme protégés afin d'éviter qu'ils soient librement volés via les systèmes liés à la mort, avec une logique dédiée pour les environnements de type Corpse.

Logs structurés

Les actions importantes sont enregistrées dans un format propre et exploitable, pratique pour la modération et la surveillance via Discord ou logs serveur.
Par exemple :

achats
renouvellements de rank
modifications de balance
reset d'achats limités
actions admin sur la boutique

Intégrations serveur

OniriaEconomy est particulièrement adapté à :

NeoForge 1.21.1
FTBRanks
FTB Chunks
Easy NPC
Corpse
PayPal

Certaines intégrations reposent sur des templates de commandes, ce qui laisse plus de liberté pour les adapter à ton serveur.

Sécurité

Le mod a été pensé avec une logique serveur sécurisée :

validation PayPal côté serveur
crédit d'OCS uniquement après confirmation du paiement
identifiants jamais exposés au client
support du stockage sécurisé des secrets
logs de transaction pour audit et support

Cas d'utilisation typiques

Ce mod est idéal pour :

boutiques donateurs / premium
abonnements VIP
kits premium à achat unique
claims payants
déblocages de NPC
récompenses via commandes personnalisées
serveurs survie ou roleplay avec progression premium

Prérequis

Minecraft 1.21.1
NeoForge 21.1.231
Java 21

Notes

Principalement conçu pour un usage serveur multijoueur
Certaines fonctions avancées dépendent de tes templates de commandes ou de mods optionnels
PayPal est optionnel si tu veux gérer les OCS manuellement