Minecraft/HomeClaim
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
61 commits 1 branch 0 tags 1.8 MiB
  • Kotlin 96.4%
  • Svelte 1.2%
  • JavaScript 0.8%
  • CSS 0.8%
  • TypeScript 0.4%
  • Other 0.4%
Find a file
Exact
DiamantTh 90e88254da Clean HomeClaim data for Paper dev runs
2026-05-14 02:04:51 +02:00
docs Add force entry workflow 2026-05-09 02:48:32 +02:00
gradle Initial import of HomeClaim project 2026-04-10 00:31:15 +02:00
homeclaim-api Add force entry workflow 2026-05-09 02:48:32 +02:00
homeclaim-api-client Initial import of HomeClaim project 2026-04-10 00:31:15 +02:00
homeclaim-core Fix Hikari startup configuration 2026-05-14 01:52:46 +02:00
homeclaim-liftlink Initial import of HomeClaim project 2026-04-10 00:31:15 +02:00
homeclaim-platform-paper Clean HomeClaim data for Paper dev runs 2026-05-14 02:04:51 +02:00
homeclaim-ux Initial import of HomeClaim project 2026-04-10 00:31:15 +02:00
homeclaim-webux Add force entry workflow 2026-05-09 02:48:32 +02:00
scripts Initial import of HomeClaim project 2026-04-10 00:31:15 +02:00
.gitignore Cancel plot jobs on world unload 2026-04-11 22:30:54 +02:00
build.gradle.kts Add guarded plot job execution 2026-04-11 14:33:52 +02:00
CHANGELOG.md Initial import of HomeClaim project 2026-04-10 00:31:15 +02:00
config.example.yml Initial import of HomeClaim project 2026-04-10 00:31:15 +02:00
generate-world.py Remove CLI world setup and optimize ingame generation 2026-04-10 04:46:59 +02:00
gradle.properties Stabilize build and migrate WebUX to SvelteKit 2026-04-10 01:22:44 +02:00
gradlew Initial import of HomeClaim project 2026-04-10 00:31:15 +02:00
gradlew.bat Initial import of HomeClaim project 2026-04-10 00:31:15 +02:00
LICENSE Initial import of HomeClaim project 2026-04-10 00:31:15 +02:00
README.md Add force entry workflow 2026-05-09 02:48:32 +02:00
settings.gradle.kts Initial import of HomeClaim project 2026-04-10 00:31:15 +02:00

README.md

HomeClaim

HomeClaim ist ein modulares Plot-/Regionen-Framework fuer Minecraft-Server. Der Core ist bewusst schlank (Regionen, Rollen, Policy-/Flag-Engine, Zonen, Events) und unterliegt der GNU AGPL v3. Module koennen darauf aufbauen - erste Referenzen sind eine UX-Schicht und LiftLink (Elevator-/Teleport-Pads).

Doku-Aufteilung

  • Kurzdoku (diese README): schneller Einstieg, Build, wichtigste Links.
  • Erweiterte Doku: docs/README_ADVANCED.md.
  • REST API: docs/api/README.md und docs/api/openapi.yaml.

Module

  • homeclaim-core: Datenmodelle, Service-Schnittstellen, Policy-Grundlagen.
  • homeclaim-ux: Referenz-Wiring fuer In-Game-/Web-UX, nutzt Core-Services.
  • homeclaim-liftlink: Bewegungs-Komponenten (Elevator-/Teleport-Pads) auf Basis des Core-Component-Service.
  • homeclaim-platform-paper: Paper/Folia-Adapter fuer MC 1.21.5+.
  • docs/db/schema.sql: SQL-Schema fuer Postgres/MariaDB/SQLite-lesbar (Regionen, Zonen, Komponenten, Rollen, Flags/Limits, Audit).

Quickstart

Build

./gradlew :homeclaim-platform-paper:shadowJar

Tests

./gradlew test

Setup im Spiel

/homeclaim setup
  • Paper: Welt erstellen; Konvertierung mit FAWE moeglich.
  • Folia: Welt erstellen unterstuetzt; Konvertierung deaktiviert.
  • Sichere Setup-Grenzen: Plotgroesse 16 bis 512, Strassenbreite 1 bis 128, Hoehe 1 bis 319.

Recovery bei unvollstaendigem Erststart

/homeclaim plot init <welt>
  • initialisiert fehlende Plot-Regionen erneut
  • ist retry-sicher und erzeugt keine doppelten Regionen
  • beim Plugin-Start wird eine unvollstaendige Plotwelt zusaetzlich automatisch nachgezogen

Entry-Deny und Staff-Override

  • Entry-Deny-Regeln sperren Betreten und Teleports auf ein Plot zielgerichtet fuer UUID, Name oder Wildcard und verlangen einen Grund.
  • API-Checks liefern Deny-ID und Grund, damit Web-/Abuse-Systeme widerspruechliche Regeln melden koennen.
  • Staff kann mit /homeclaim entryforce <player|uuid> <here|any|regionUuid> <reason...> einen kurzlebigen Override fuer Support-/Admin-Teleports vergeben.
  • Dauerhafte Bypass-Rolle: homeclaim.admin.entry.denied; begruendeter Force-Grant: homeclaim.admin.entry.force.

Wichtige Links

  • Erweiterte Architektur-, Config- und Betriebsdoku: docs/README_ADVANCED.md
  • API Doku: docs/api/README.md
  • OpenAPI: docs/api/openapi.yaml
  • DB Schema: docs/db/schema.sql
  • Lizenz: LICENSE

Lizenz

HomeClaim Core steht unter der GNU Affero General Public License v3 (siehe LICENSE). Module sollten kompatible Lizenzen nutzen.