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

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/gadlab/glb-valblocs/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/gadlab/glb-valblocs ↗

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