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