Terracotta Client
by Owlfroggy
Terracotta Client lets external applications such as VSCode connect to DiamondFire and edit plot code directly, once the user grants them access.
What it does
Terracotta Client is a client-side Fabric mod that allows external applications such as VSCode to work with DiamondFire editing. It enables the Terracotta VSCode extension to integrate with DiamondFire, so code can be written and changed from the editor while the player stays on a plot. Plot code can switch between modes and manage the inventory through this connection.
No external application can act until the player approves it. A program that has already been verified can reconnect and act for up to 30 days without another prompt. The connection is only enabled on the DiamondFire server, and the mod has no effect outside it. Terracotta Client requires Fabric API, and Mod Menu is an optional companion for its settings screen.
The mod is published for Fabric only, for game version 26.2, with the 1.0.2 file dated 2026-10-01 as the latest build. It is open source under the BSD 3-Clause License, and its source code, issue tracker and wiki are public. Only the player's client needs it, so servers do not have to install anything.
Key features
VSCode integration
Connects the Terracotta VSCode extension to DiamondFire so plot code can be edited from an external editor.
Permission prompt
Each external application must be granted permission before it can take any action on the player's plot.
Authenticated reconnection
A previously approved application can reconnect for 30 days without another confirmation step.
Inventory and mode control
Plot code can switch between modes and manage the player's inventory through the connected application.
DiamondFire-only activation
The connection works only on the DiamondFire server and has no effect in other games or servers.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Optional 1
How it compares
DFScript is a Fabric client mod for 1.19 – 1.20.4 under the GNU Lesser General Public License v3.0 only, and it is open source. MwonMod is also a Fabric client mod, published for 1.21.3 – 26.2 under the GNU General Public License v3.0 only, and it is open source. modmod is a Fabric client mod for 1.21.11 under the MIT License, and it is open source. Terracotta Client differs from these in its external-application permission model and its VSCode integration, and it covers only 26.2.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Terracotta Client | Fabric | 26.2 | Client-side only | 2026-10-01 |
| DFScript | Fabric | 1.19 – 1.20.4 | Client-side only | 2024-05-21 |
| MwonMod | Fabric | 1.21.3 – 26.2 | Client-side only | 2026-09-03 |
| modmod | Fabric | 1.21.11 | Client-side only | 2026-06-02 |
Questions
Does Terracotta Client need Fabric API?
Does the server need to install Terracotta Client?
How long does an approved application stay connected?
In the catalog
Terracotta Client is one of 8,016 Management mods on ModsFinder, and one of 5,930 Management mods for Fabric. 13,894 mods support Minecraft 26.2.
Similar mods
What the author says
Terracotta Client allows external applications (such as VSCode) to integrate directly with DiamondFire by editing plot code, switching between modes, and managing your inventory. External apps cannot take action until they have been granted permission. Once an application has been authenticated, it may freely…
Official listing
- Modrinth page
- modrinth.com/mod/terracotta-client
- Owner
- Owlfroggy
- Published
- 2026-07-08
- Updated on Modrinth
- 2026-10-01
- Facts verified
- 2026-10-15