diff --git a/PLATFORM.md b/PLATFORM.md index a74b30d..8aa9136 100644 --- a/PLATFORM.md +++ b/PLATFORM.md @@ -1,7 +1,8 @@ # Shared platform and build baseline -TFMC plugins target **Java 21 / Minecraft 1.21.10**, using the Paper or Spigot -1.21.10 API with `provided` scope. Plugin descriptors declare API 1.21.10. +TFMC plugins target **Java 21 / Minecraft 1.21.10**, using +`io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope. +Plugin descriptors declare API 1.21.10. ## Runtime and toolchain @@ -51,8 +52,8 @@ mvn clean verify ``` The compiler's `release=21` setting controls bytecode and available Java APIs. -Paper and Spigot dependencies resolve from their Maven repositories and are not -bundled into plugin jars. Prepare private third-party dependencies with the +Paper API resolves from the [PaperMC Maven repository](https://repo.papermc.io/repository/maven-public/) +and is not bundled into plugin jars. Prepare private third-party dependencies with the repository's `.github/scripts/prepare-release.sh`; it verifies `.github/dependencies.sha256` where present. @@ -68,40 +69,41 @@ consumer set. Source builds must pass clean verification before publication. | --- | --- | --- | --- | | [AACommandsFiller](projects/AACommandsFiller/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | | [ActivityTF](projects/ActivityTF/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | -| [AdvancedCrafting](projects/AdvancedCrafting/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [AdvancedGunpowder](projects/AdvancedGunpowder/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [AdvancedResearch](projects/AdvancedResearch/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [ArmourShop](projects/ArmourShop/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [BarterShops](projects/BarterShops/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [BirdMessenger](projects/BirdMessenger/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [Cooking](projects/Cooking/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | +| [AdvancedCrafting](projects/AdvancedCrafting/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [AdvancedGunpowder](projects/AdvancedGunpowder/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [AdvancedResearch](projects/AdvancedResearch/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [Archaeo](projects/Archaeo/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [ArmourShop](projects/ArmourShop/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [BarterShops](projects/BarterShops/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [BirdMessenger](projects/BirdMessenger/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [Cooking](projects/Cooking/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | | [CoreProtect](projects/CoreProtect/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | -| [DenarEconomy](projects/DenarEconomy/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [DrinkBuilder](projects/DrinkBuilder/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [Games](projects/Games/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | +| [DenarEconomy](projects/DenarEconomy/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [DrinkBuilder](projects/DrinkBuilder/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [Games](projects/Games/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | | [GeigerCounters](projects/GeigerCounters/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | -| [GemInfusion](projects/GemInfusion/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [Goldsmithing](projects/Goldsmithing/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [GunsAndGadgets](projects/GunsAndGadgets/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [InteractibleFurniture](projects/InteractibleFurniture/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [Magic](projects/Magic/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [MarketBlock](projects/MarketBlock/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | +| [GemInfusion](projects/GemInfusion/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [Goldsmithing](projects/Goldsmithing/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [GunsAndGadgets](projects/GunsAndGadgets/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [InteractibleFurniture](projects/InteractibleFurniture/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [Magic](projects/Magic/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [MarketBlock](projects/MarketBlock/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | | [MusicalInstruments](projects/MusicalInstruments/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | -| [Nutrition](projects/Nutrition/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [PermCleaner](projects/PermCleaner/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [PointShop](projects/PointShop/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [Recycler](projects/Recycler/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | +| [Nutrition](projects/Nutrition/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [PermCleaner](projects/PermCleaner/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [PointShop](projects/PointShop/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [Recycler](projects/Recycler/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | | [RPCharacters](projects/RPCharacters/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | -| [SimpleFactions](projects/SimpleFactions/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | +| [SimpleFactions](projects/SimpleFactions/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | | [Surgery](projects/Surgery/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | | [TFMCCore](projects/TFMCCore/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | -| [TFMCWeb](projects/TFMCWeb/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [Thievery](projects/Thievery/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [TLibs](projects/TLibs/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [VehicleFramework](projects/VehicleFramework/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [VFBuilders](projects/VFBuilders/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [Woodworking](projects/Woodworking/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | -| [WorldBorder](projects/WorldBorder/README.md) | 21 | `spigot-api` | `1.21.10-R0.1-SNAPSHOT` | +| [TFMCWeb](projects/TFMCWeb/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [Thievery](projects/Thievery/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [TLibs](projects/TLibs/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [VehicleFramework](projects/VehicleFramework/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [VFBuilders](projects/VFBuilders/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [Woodworking](projects/Woodworking/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | +| [WorldBorder](projects/WorldBorder/README.md) | 21 | `paper-api` | `1.21.10-R0.1-SNAPSHOT` | ProvinceSystem is a web/backend project. ServerAssets contains configurations, models, resource packs, and private build inputs. Neither produces a plugin jar. diff --git a/projects/AdvancedCrafting/setup.md b/projects/AdvancedCrafting/setup.md index 08f2b07..040000b 100644 --- a/projects/AdvancedCrafting/setup.md +++ b/projects/AdvancedCrafting/setup.md @@ -6,7 +6,7 @@ Use Java 21 and Minecraft 1.21.10 under the [shared platform baseline](../../PLATFORM.md). The plugin descriptor requires TLibs, MMOCore, MMOItems and MythicLib. The -build resolves Spigot API 1.21.10 from Maven and declares `api-version: 1.21.10`. Configured ItemsAdder furniture requires ItemsAdder and the matching +build resolves Paper API 1.21.10 from Maven and declares `api-version: 1.21.10`. Configured ItemsAdder furniture requires ItemsAdder and the matching server assets. These third-party plugins are installed separately. For a new server, while stopped, create `plugins/AdvancedCrafting/` and copy the diff --git a/projects/AdvancedGunpowder/README.md b/projects/AdvancedGunpowder/README.md index e1cf28b..56cc3e0 100644 --- a/projects/AdvancedGunpowder/README.md +++ b/projects/AdvancedGunpowder/README.md @@ -10,7 +10,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. **Archived:** The source on `main` targets Java 21 / Minecraft 1.21.10. -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. Populate `libs/` with the exact files and hashes listed in `.github/dependencies.sha256`. `.github/scripts/prepare-release.sh` downloads those pinned private assets when supplied with the approved dependency token. diff --git a/projects/AdvancedResearch/README.md b/projects/AdvancedResearch/README.md index bb4953a..570cb0f 100644 --- a/projects/AdvancedResearch/README.md +++ b/projects/AdvancedResearch/README.md @@ -10,7 +10,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. **Archived:** The source on `main` targets Java 21 / Minecraft 1.21.10. -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. Populate `libs/` with the exact files and hashes listed in `.github/dependencies.sha256`. `.github/scripts/prepare-release.sh` downloads those pinned private assets when supplied with the approved dependency token. diff --git a/projects/ArmourShop/README.md b/projects/ArmourShop/README.md index d570265..bd98727 100644 --- a/projects/ArmourShop/README.md +++ b/projects/ArmourShop/README.md @@ -8,7 +8,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. ## Build and dependencies -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. Install these matching Java 21 TFMC artifacts into local Maven before building: `me.plugins:tlibs:2.0.0`, `net.tfminecraft:gunsandgadgets:2.0.0`. Use the [shared installer](../TLibs/README.md) for published dependencies, or `mvn clean install` from matching source versions. CI uses the shared dependency setup actions. diff --git a/projects/BarterShops/README.md b/projects/BarterShops/README.md index 130aa57..938dc21 100644 --- a/projects/BarterShops/README.md +++ b/projects/BarterShops/README.md @@ -8,7 +8,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. ## Build and dependencies -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. Install these matching Java 21 TFMC artifacts into local Maven before building: `net.tfminecraft:denareconomy:0.2.0`, `net.tfminecraft:simplefactions:3.0.0`. Their source repositories use `mvn clean install`; CI uses the pinned dependency setup actions. diff --git a/projects/BirdMessenger/README.md b/projects/BirdMessenger/README.md index 1efcdbf..5ab84f3 100644 --- a/projects/BirdMessenger/README.md +++ b/projects/BirdMessenger/README.md @@ -8,7 +8,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. ## Build and dependencies -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. Install these matching Java 21 TFMC artifacts into local Maven before building: `me.plugins:tlibs:2.0.0`, `net.tfminecraft:rpcharacters:2.0.0`. Use the [shared installer](../TLibs/README.md) for published dependencies, or `mvn clean install` from matching source versions. CI uses the shared dependency setup actions. diff --git a/projects/Cooking/README.md b/projects/Cooking/README.md index 12a22e0..a3a0a0c 100644 --- a/projects/Cooking/README.md +++ b/projects/Cooking/README.md @@ -10,7 +10,7 @@ See the [shared API versions](../../PLATFORM.md#shared-api-versions) for the mat ## Build and dependencies -Run Maven from the source checkout. The current [POM](https://github.com/TF-Minecraft/cooking/blob/main/pom.xml) declares Java **release 21** and **spigot-api 1.21.10-R0.1-SNAPSHOT**; [plugin.yml](https://github.com/TF-Minecraft/cooking/blob/main/src/main/resources/plugin.yml) declares `api-version: 1.21.10`. The build and loader metadata target the shared runtime. Gameplay validation remains separate from build verification. +Run Maven from the source checkout. The current [POM](https://github.com/TF-Minecraft/cooking/blob/main/pom.xml) declares Java **release 21** and **paper-api 1.21.10-R0.1-SNAPSHOT**; [plugin.yml](https://github.com/TF-Minecraft/cooking/blob/main/src/main/resources/plugin.yml) declares `api-version: 1.21.10`. The build and loader metadata target the shared runtime. Gameplay validation remains separate from build verification. Use JDK 21, install the matching TLibs Maven artifact (`me.plugins:tlibs`, version from `tlibs.version`), install the other TFMC Maven dependencies listed in the POM, and populate `libs/` using the pinned private dependency preparation script. Run `mvn clean verify`; the artifact stays in `target/`. Optional runtime integrations can still be required at compile time. diff --git a/projects/DenarEconomy/README.md b/projects/DenarEconomy/README.md index 08d3220..f7b0e36 100644 --- a/projects/DenarEconomy/README.md +++ b/projects/DenarEconomy/README.md @@ -8,7 +8,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. ## Build and dependencies -Run Maven from the source checkout. The current [POM](https://github.com/TF-Minecraft/denareconomy/blob/main/pom.xml) declares Java **release 21** and **spigot-api 1.21.10-R0.1-SNAPSHOT**; [plugin.yml](https://github.com/TF-Minecraft/denareconomy/blob/main/src/main/resources/plugin.yml) declares `api-version: 1.21.10`. The build and loader metadata target the shared runtime. Gameplay validation remains separate from build verification. +Run Maven from the source checkout. The current [POM](https://github.com/TF-Minecraft/denareconomy/blob/main/pom.xml) declares Java **release 21** and **paper-api 1.21.10-R0.1-SNAPSHOT**; [plugin.yml](https://github.com/TF-Minecraft/denareconomy/blob/main/src/main/resources/plugin.yml) declares `api-version: 1.21.10`. The build and loader metadata target the shared runtime. Gameplay validation remains separate from build verification. Build with JDK 21. Install the matching TLibs Maven release and populate `libs/` using `.github/scripts/prepare-release.sh`, then verify `.github/dependencies.sha256` and run `mvn clean verify`. The primary output is `target/denareconomy-0.1.9.jar`. The current CI workflow records the exact dependency setup. diff --git a/projects/DrinkBuilder/README.md b/projects/DrinkBuilder/README.md index 145a382..4115256 100644 --- a/projects/DrinkBuilder/README.md +++ b/projects/DrinkBuilder/README.md @@ -8,7 +8,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. ## Build and dependencies -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. Install these matching Java 21 TFMC artifacts into local Maven before building: `me.plugins:tlibs:2.0.0`. Use the [shared installer](../TLibs/README.md) for published dependencies, or `mvn clean install` from matching source versions. CI uses the shared dependency setup actions. diff --git a/projects/Games/docs/SYSTEM.md b/projects/Games/docs/SYSTEM.md index 264bd94..6518371 100644 --- a/projects/Games/docs/SYSTEM.md +++ b/projects/Games/docs/SYSTEM.md @@ -68,7 +68,7 @@ Same spawn / metadata / destroy idea as RPCharacters speech bubbles and clues (` - Fake entities are not clickable. Spawn a real **Interaction** on the deck for right-click draw. - Table title is a real **TextDisplay** (everyone should see "Poker"). Do not reuse packet speech bubbles for that. -Validate ItemDisplay metadata indices against the deployed **Minecraft 1.21.10** server and ProtocolLib build when changing display code. The POM compiles against Spigot API 1.21.10; a successful compile does not verify packet metadata. Scale uses `org.joml.Vector3f` with ProtocolLib `Registry.get(Vector3f.class)`. +Validate ItemDisplay metadata indices against the deployed **Minecraft 1.21.10** server and ProtocolLib build when changing display code. The POM compiles against Paper API 1.21.10; a successful compile does not verify packet metadata. Scale uses `org.joml.Vector3f` with ProtocolLib `Registry.get(Vector3f.class)`. Display API (dumb): `spawn(token)`, `despawn`, `setItem`, `setItemFor(player, item)`, `setTransform(token, transform, durationTicks)`, plus join / chunk refresh. diff --git a/projects/GemInfusion/README.md b/projects/GemInfusion/README.md index 755a5b2..38b653d 100644 --- a/projects/GemInfusion/README.md +++ b/projects/GemInfusion/README.md @@ -9,7 +9,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. ## Build and dependencies Run `mvn clean verify` with JDK 21 from the source checkout. The POM -uses **release 21**, resolves **Spigot API 1.21.10-R0.1-SNAPSHOT** from Maven, +uses **release 21**, resolves **Paper API 1.21.10-R0.1-SNAPSHOT** from Maven, and declares `api-version: 1.21.10` in the plugin manifest. Install the TLibs version declared in `pom.xml` using the diff --git a/projects/Goldsmithing/README.md b/projects/Goldsmithing/README.md index 6a3c072..670cfd7 100644 --- a/projects/Goldsmithing/README.md +++ b/projects/Goldsmithing/README.md @@ -10,7 +10,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. **Archived:** The source on `main` targets Java 21 / Minecraft 1.21.10. -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. Populate `libs/` with the exact files and hashes listed in `.github/dependencies.sha256`. `.github/scripts/prepare-release.sh` downloads those pinned private assets when supplied with the approved dependency token. diff --git a/projects/InteractibleFurniture/README.md b/projects/InteractibleFurniture/README.md index c2dafe3..37c9b0a 100644 --- a/projects/InteractibleFurniture/README.md +++ b/projects/InteractibleFurniture/README.md @@ -14,7 +14,7 @@ Use JDK 21 and `mvn clean verify` from `main`. Install the TLibs version declared in `pom.xml` with the [shared installer](../TLibs/README.md) in pinned mode. Prepare the private inputs in `libs/` with `.github/scripts/prepare-release.sh` and verify `.github/dependencies.sha256`. -The POM uses the Spigot 1.21.10 API and writes the JAR under `target/` using +The POM uses the Paper 1.21.10 API and writes the JAR under `target/` using its declared version. Validate server behavior against the intended dependencies. The plugin manifest requires TLibs and MythicMobs. ProtocolLib is also a build diff --git a/projects/Nutrition/README.md b/projects/Nutrition/README.md index 15c0045..b49578c 100644 --- a/projects/Nutrition/README.md +++ b/projects/Nutrition/README.md @@ -10,7 +10,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. **Archived:** The source on `main` targets Java 21 / Minecraft 1.21.10. -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. Install the TLibs version declared in `pom.xml` using the [shared installer](../TLibs/README.md) with `--mode pinned`. See the diff --git a/projects/PermCleaner/README.md b/projects/PermCleaner/README.md index 2f2a308..5d9f7a7 100644 --- a/projects/PermCleaner/README.md +++ b/projects/PermCleaner/README.md @@ -8,7 +8,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. ## Build and dependencies -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. Install these matching Java 21 TFMC artifacts into local Maven before building: `me.plugins:tlibs:2.0.0`. Use the [shared installer](../TLibs/README.md) for published dependencies, or `mvn clean install` from matching source versions. CI uses the shared dependency setup actions. diff --git a/projects/PointShop/README.md b/projects/PointShop/README.md index 4a4153b..4112d8e 100644 --- a/projects/PointShop/README.md +++ b/projects/PointShop/README.md @@ -10,7 +10,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. **Archived:** The source on `main` targets Java 21 / Minecraft 1.21.10. -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. Install the TLibs version declared in `pom.xml` using the [shared installer](../TLibs/README.md) with `--mode pinned`. See the diff --git a/projects/SimpleFactions/overview.md b/projects/SimpleFactions/overview.md index bd74712..cc56594 100644 --- a/projects/SimpleFactions/overview.md +++ b/projects/SimpleFactions/overview.md @@ -29,7 +29,7 @@ This project also demonstrates cross-language integration through **ProvinceSyst ## Technical Overview - Runtime target: TFMC Minecraft **1.21.10**; follow the [shared platform baseline](../../PLATFORM.md). -- Build with JDK 21 and Maven. The POM targets Java 21 bytecode (`maven.compiler.release=21`) and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope. +- Build with JDK 21 and Maven. The POM targets Java 21 bytecode (`maven.compiler.release=21`) and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope. - Supply the authorized private JARs in `libs/` using the repository’s dependency preparation script and checksum file. Install matching Java 21 TLibs, RPCharacters, DenarEconomy, VehicleFramework and VFBuilders builds in local Maven before `mvn clean verify`. The shared baseline explains release status and dependency cycles. ### Architecture diff --git a/projects/TFMCWeb/README.md b/projects/TFMCWeb/README.md index 860a2c5..1a88075 100644 --- a/projects/TFMCWeb/README.md +++ b/projects/TFMCWeb/README.md @@ -14,7 +14,7 @@ The entrypoint is `net.tfminecraft.tfmcweb.TFMCWeb`. TLibs is a required plugin; ## Build and dependencies -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. Install these matching Java 21 TFMC artifacts into local Maven before building: `me.plugins:tlibs:2.0.0`. Use the [shared installer](../TLibs/README.md) for published dependencies, or `mvn clean install` from matching source versions. CI uses the shared dependency setup actions. diff --git a/projects/VFBuilders/README.md b/projects/VFBuilders/README.md index 4c38abc..c86aecd 100644 --- a/projects/VFBuilders/README.md +++ b/projects/VFBuilders/README.md @@ -11,7 +11,7 @@ VFBuilders adds configurable vehicle-building stations and blueprints to ## Setup and build -Use JDK 21 and Maven from `main`. The POM resolves Spigot API +Use JDK 21 and Maven from `main`. The POM resolves Paper API **1.21.10-R0.1-SNAPSHOT** with `provided` scope and targets Java 21. Install the declared TLibs and VehicleFramework versions with the [shared installer](../TLibs/README.md) in pinned mode. diff --git a/projects/VehicleFramework/overview.md b/projects/VehicleFramework/overview.md index 26645b0..2803d42 100644 --- a/projects/VehicleFramework/overview.md +++ b/projects/VehicleFramework/overview.md @@ -1,10 +1,10 @@ # VehicleFramework A highly configurable system to allow semi-realistic vehicles with weapons in Minecraft -You will not be able to run this as a standalone program, due to it being dependent on other plugins and the spigot server environment. +You will not be able to run this as a standalone program, due to it being dependent on other plugins and the Paper server environment. ## Why This Project Is Interesting -This framework implements several systems that do not exist in the standard Spigot API, including: +This framework implements several systems that do not exist in the standard Paper API, including: - **Full 3D rotation (pitch/yaw/roll)** - Minecraft normally exposes only yaw and limited pitch control. I implemented full rotational freedom for vehicles and weapon systems. - **Player-controlled turrets** - Instead of simply spawning a projectile in the direction the player is looking (the default behavior), the turret physically rotates, aims, and fires based on its own orientation. The projectile direction is derived from the turret’s current rotation, not the player’s. @@ -23,7 +23,7 @@ TFMC's runtime baseline is **Minecraft 1.21.10**; see the [shared platform guide](../../PLATFORM.md) for build conventions and the [current source declarations](../../PLATFORM.md#plugin-build-targets). -- Java 21 compiler/runtime target, with Spigot API 1.21.10 from Maven. +- Java 21 compiler/runtime target, with Paper API 1.21.10 from Maven. - Built using Maven ### Architecture: - Main class intializes managers and plugin setup ([VehicleFramework.java](https://github.com/TF-Minecraft/VehicleFramework/blob/main/src/main/java/net/tfminecraft/vehicleframework/VehicleFramework.java)) diff --git a/projects/Woodworking/README.md b/projects/Woodworking/README.md index 35630d0..de3d7ed 100644 --- a/projects/Woodworking/README.md +++ b/projects/Woodworking/README.md @@ -10,7 +10,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. ## Build and dependencies -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. Install these matching Java 21 TFMC artifacts into local Maven before building: `me.plugins:tlibs:2.0.0`. Use the [shared installer](../TLibs/README.md) for published dependencies, or `mvn clean install` from matching source versions. CI uses the shared dependency setup actions. diff --git a/projects/WorldBorder/README.md b/projects/WorldBorder/README.md index 925508c..816291a 100644 --- a/projects/WorldBorder/README.md +++ b/projects/WorldBorder/README.md @@ -12,7 +12,7 @@ TFMC runs Minecraft **1.21.10**. See the [shared platform and build baseline](.. ## Build and dependencies -Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `org.spigotmc:spigot-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from Spigot snapshots. The plugin descriptor declares `api-version: 1.21.10`. +Run Maven with **JDK 21** from the source checkout. The POM sets `maven.compiler.release=21` and resolves `io.papermc.paper:paper-api:1.21.10-R0.1-SNAPSHOT` with `provided` scope from the PaperMC Maven repository. The plugin descriptor declares `api-version: 1.21.10`. No private `libs/` JARs are required by this POM.