Documentation / ZMC-SMPEngine

A modular engine for building a custom SMP game mode without starting from scratch.

A practical reference for installing and configuring this ZMConcepts plugin.

Quick setup: Upload the plugin to your server, review the generated configuration and adjust the options for your community.

Overview

What this project does and what you can configure on your server.

An evolving SMP foundation that combines gameplay rules, data storage and configuration in one system.

Gameplay modules

Lives, resources, abilities, items, artifacts and player progression share one foundation.

Player data

Progress and statistics are stored in a local database.

Server rules

Game-mode rules can be shaped through modules and configuration.

Configuration

Upload the plugin to your server, review the generated configuration and adjust the options for your community.

Requirements

Platform
Paper
Minecraft
26.1.2
Java
25
Storage
SQLite
Status
In development

Commands

/smp

Shows SMP engine help and status.

zmcsmp.use
/smp profile [gracz]

Shows a profile and key statistics.

zmcsmp.profile.self
/smp resources

Lists configured resources.

zmcsmp.resources.view
/smp pay <gracz> <zasób> <ilość>

Transfers a tradeable resource to another player.

zmcsmp.resources.pay
/smp bounty list

Lists active player bounties.

zmcsmp.bounty.view
/smp ability

Shows abilities and their cooldowns.

zmcsmp.ability.view
/smp top <zasób>

Shows a leaderboard for a resource.

zmcsmp.top.view
/smp heart withdraw <ilość>

Converts own hearts into configured items.

zmcsmp.life.withdraw
/smp admin inspect <gracz>

Shows a full player state to an administrator.

zmcsmp.admin.inspect
/smp admin diagnostics

Shows module and storage status.

zmcsmp.admin.diagnostics
/smp admin config validate

Validates the configuration.

zmcsmp.admin.config

Permissions

  • zmcsmp.use
  • zmcsmp.profile.self
  • zmcsmp.profile.others
  • zmcsmp.resources.view
  • zmcsmp.resources.pay
  • zmcsmp.bounty.view
  • zmcsmp.bounty.create
  • zmcsmp.ability.view
  • zmcsmp.gem.view
  • zmcsmp.milestone.view
  • zmcsmp.top.view
  • zmcsmp.life.withdraw
  • zmcsmp.admin.inspect
  • zmcsmp.admin.life
  • zmcsmp.admin.resource
  • zmcsmp.admin.eliminate
  • zmcsmp.admin.revive
  • zmcsmp.admin.grace
  • zmcsmp.admin.ability
  • zmcsmp.admin.artifact
  • zmcsmp.admin.bounty
  • zmcsmp.admin.milestone
  • zmcsmp.admin.audit
  • zmcsmp.admin.diagnostics
  • zmcsmp.admin.config
  • zmcsmp.admin.export
  • zmcsmp.admin.rule
  • zmcsmp.admin.updatenotify
  • zmcsmp.admin.preset
  • zmcsmp.admin.preset.install
  • zmcsmp.admin.*

Placeholders

  • %zmcsmp_hearts%
  • %zmcsmp_hearts_max%
  • %zmcsmp_eliminated%
  • %zmcsmp_grace_active%
  • %zmcsmp_in_combat%
  • %zmcsmp_resource_<id>%
  • %zmcsmp_progression_<track>_level%
  • %zmcsmp_kills%
  • %zmcsmp_deaths%
  • %zmcsmp_kdr%
  • %zmcsmp_killstreak%
  • %zmcsmp_bounty_amount%
  • %zmcsmp_ability_<id>_cooldown%

Integrations

—