WP Manifestindependent plugin directory
manifest / users / glb-valblocs

Valblocs · WP plugin · Gamification of collaborative skills

A WordPress plugin for gamification on colaborative skills in the Minecraft game.

by Gad Lab · github.com/gadlab/glb-valblocs · website

★ 1stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/gadlab/glb-valblocs/archive/refs/heads/main.zip

Readme

Gad Lab — Valblocs

Système de récompenses pour la zone membres du clan Valdris (Minecraft Java Edition)

Version: 3.8.0 · WordPress: 6.0+ · PHP: 8.0+ · Licence: GPL-2.0+

Description

Plugin WordPress qui gère l'économie interne du clan Valdris : la monnaie virtuelle Valblocs.
Il s'appuie sur GamiPress (points/rangs), BuddyPress (activités sociales) et WP Swings (abonnements).

Fonctionnalités principales

Fonctionnalité Description
Multiplicateurs de palier Novice ×1 · Bâtisseur ×1,25 · Artisan ×1,5 · Landlord ×2
Conversion Valblocs → jours d'abonnement Taux configurable (défaut : 2 Valblocs = 1 jour, scénario B)
Don entre membres Quota quotidien de 30 Valblocs, validé côté serveur
Validation Landlord Un Landlord peut approuver/refuser manuellement un don
Hooks BuddyPress Récompenses sur mentions « J'aime » (posté et reçu)
Welcome bonus Crédit unique au premier accès BuddyPress
Onglet Serveur Java Interface admin pour piloter le serveur Minecraft via valdris-agent (API HTTP)
Shortcodes [gadlab_balance] · [gadlab_convert_form] · [gadlab_don_form] · [gadlab_transactions] · [gadlab_user_card] · [gadlab_top_blocs]

Dépendances

Plugin Rôle Obligatoire
GamiPress Points & rangs ✅
BuddyPress Activité sociale ✅
WP Swings Subscriptions Abonnements ✅
jQuery AJAX frontend Inclus WP

Installation

# Cloner dans le dossier plugins WordPress
cd /var/www/html/wp-content/plugins/
git clone https://github.com/gadlab/gadlab-gamification_local.git glb-valblocs

Activer le plugin depuis Extensions → Gad Lab — Valblocs.

Configuration

Taux de conversion

Dans glb-valblocs.php, modifier la constante :

define('GADLAB_CONVERSION_RATE', 2); // Scénario B : 2 Valblocs = 1 jour
// define('GADLAB_CONVERSION_RATE', 1); // Scénario A : 1:1

Onglet Serveur Java

Dans Administration → Valblocs → Serveur Java, configurer :

  • URL de l'agent : http://<node-ip>:<port> (agent valdris-agent.py sur le nœud Docker Jelastic)
  • Token d'authentification : jeton Bearer attendu par l'agent
  • Timeout : délai HTTP (défaut : 10 s)

Shortcodes

[gadlab_balance]          — Solde Valblocs de l'utilisateur courant
[gadlab_convert_form]     — Formulaire de conversion Valblocs → jours d'abonnement
[gadlab_don_form]         — Formulaire de don vers un autre membre
[gadlab_transactions]     — Historique des transactions
[gadlab_user_card]        — Carte profil off-canvas
[gadlab_top_blocs]        — Classement des membres par Valblocs

Structure du projet

glb-valblocs/
├── glb-valblocs.php          ← Plugin principal (business logic)
├── gadlab-server-tab.php     ← Onglet Serveur Java Minecraft
├── assets/
│   ├── css/
│   │   └── gadlab-admin.css  ← Styles administration
│   └── gadlab-gamification.js
├── .vscode/
│   └── settings.json
├── .gitignore
├── CHANGELOG.md
└── README.md

Workflow Git

main        ← production (déployé manuellement sur Jelastic)
develop     ← staging (auto-déployé via webhook sur node202568)
feature/*   ← développement

Backlog v3.x

Priorité haute

  • [x] Champ UUID Minecraft dans les profils WP admin (show_user_profile / edit_user_profile) — v3.1.0
  • [x] Validation UUID Mojang au checkout WooCommerce — v3.1.0
  • [x] Whitelist automatique Minecraft après commande complétée — v3.1.0

Priorité moyenne

  • [ ] Formulaire Duo (2 UUIDs) dans Fluent Forms
  • [ ] Refactoring OOP (classes au lieu de fonctions globales)
  • [ ] REST API propre pour les intégrations externes

Priorité basse

  • [ ] Persistance agent Valderia au boot Jelastic (cron ou supervisor)
  • [ ] WooCommerce Subscriptions automatiques (actuellement manuel Stripe)

Licence

GPL-2.0+ — voir https://www.gnu.org/licenses/gpl-2.0.html

Auteur : Gad Lab · https://minecraft.gadlab.net

Read the full README on GitHub →