Modrinth · Fabric

Distant Decorations auf deinem Minecraft Server

Distant Decorations läuft auf Minecraft Servern mit Fabric. Bestell deinen Server, stell den Loader im Panel ein und installiere die Mod mit einem Klick im Mod-Browser.

Distant Decorations is a high-performance Fabric framework that lets participating mods persist and render decorative block-entity visuals far beyond vanilla chunk distances.

Downloads
2.2K
Autor
–
Loader
Fabric
Minecraft
26.2 – 26.3
Aktualisiert
–

Screenshots

So sieht Distant Decorations aus

Bilder: Distant Decorations auf Modrinth, vom Projektteam veröffentlicht.

Einrichtung

Distant Decorations auf dem Server installieren

Server und Spieler brauchen denselben Loader und dieselbe Minecraft-Version. Sichere die Welt, bevor du Mods hinzufügst oder aktualisierst.

  1. 01

    Konfigurieren

    4 GB RAM sind vorausgewählt. Laufzeit und Add-ons wählst du selbst, bezahlt wird per Kreditkarte oder PayPal.

  2. 02

    Loader einstellen

    Stell im Panel die Serversoftware auf Fabric und wähl die passende Minecraft-Version, zum Beispiel 26.3.

  3. 03

    Mod installieren

    Such im Mod-Browser nach „Distant Decorations“ und installiere die Version für deinen Loader. Alternativ lädst du die .jar per SFTP in den Ordner mods. Erforderliche Abhängigkeiten stehen auf der Projektseite.

  4. 04

    Verbinden

    Alle Spieler installieren Distant Decorations in derselben Version lokal und verbinden sich über die Serveradresse aus dem Panel.

Auf dem Server
Erforderlich
Auf dem Client
Erforderlich
Loader
Fabric
Minecraft
26.3, 26.2
Lizenz
Mozilla Public License 2.0

Das Panel

Mods installieren, Fehler finden.

Echte Screenshots aus dem Mado Panel. Beides ist bei jedem Minecraft Server enthalten.

Mod-Browser

Modrinth und CurseForge direkt im Panel.

Der Browser filtert nach deiner Minecraft-Version. Mods installierst du mit einem Klick, ohne .jar-Dateien hochzuladen.

Browser im Mado Panel mit Suche, Quellenwahl CurseForge oder Modrinth und Install-Buttons.

KI-Crash-Analyse

Wenn ein Mod crasht, liest die Analyse das Log.

Mods scheitern oft an einer falschen Loader-Version, Java-Version oder fehlenden Abhängigkeit. Die Analyse nennt eine wahrscheinliche Ursache und einen Lösungsvorschlag.

Optimierungsseite im Mado Panel mit aktiviertem KI-Log-Analyzer und der Meldung „Server Crashed“ samt Button „Analyze Now“.

Versionen

Veröffentlichte Versionen

Nimm die Datei, die zu Loader und Minecraft-Version deines Servers passt. Server und Spieler brauchen dieselbe Version.

Distant Decorations · Modrinth
Originalbeschreibung des Projektautors

Distant Decorations

Minecraft
Fabric API
Java
License

Distant Decorations is a high-performance Fabric framework for Minecraft 26.2 that lets participating mods persist and render decorative block-entity visuals far beyond vanilla chunk distances. Its default client subscription range is 512 chunks (8,192 blocks), with a server-authoritative maximum of 1,024 chunks (16,384 blocks). Integrations such as Fast Paintings and Camerapture provide their own lightweight server metadata providers and distant client renderers.

By decoupling visual representation from ticking block entities and leveraging hierarchical spatial indexing, projected-size culling, and bounded top-K selection, Distant Decorations keeps distant-decoration traversal in the low-millisecond range even with large synchronized datasets—seamlessly coexisting with long-distance terrain renderers like Voxy.


🌟 Key Features

  • Extreme Visibility Range: Extends decoration visibility up to 512 chunks (8,192 blocks) by default, with server support for subscriptions up to 1,024 chunks (16,384 blocks), independent of vanilla chunk render distance.
  • Hierarchical Spatial Indexing:
    • 4×4 Chunk Cells (64×64 blocks): Aggregate bounding box calculation for instantaneous coarse frustum culling.
    • 32×32 Chunk Regions (512×512 blocks): Monotonic revision tracking, dirty-region flushing (every 5s), and idle eviction (60s).
  • Dynamic Level of Detail (LOD) & Far-Visual Scaling:
    • Provider-Aware Projected-Size Culling: Allows renderers to specify custom subpixel culling thresholds via cullBelowProjectedPixelSize() (defaults to global 0.10 px, configurable down to 0.01 px).
    • Far-LOD Footprint Support: Core delivers precise projection metrics and non-culled submissions so provider renderers can scale subpixel distant quads around their center to maintain a rasterizable ~1 px visual footprint (e.g. clamped up to 16x without altering physical world AABBs.
  • Flicker-Free Live Handoff:
    • Dynamic distance threshold (64 x entityDistanceScaling blocks) and a 200 ms chunk-load grace period ensuring seamless transitions between live block entity renderers and Distant Decorations.
    • Real-time mutation capture (MixinBlockEntity) tracking block entity updates (setChanged) and removals in active chunks.
  • OBE Coexistence: Designed to cleanly coexist with OptimisedBlockEntities (OBE) by operating completely independently of ticking block entity lifecycles.
  • Chunky Integration: Safely intercepts asynchronous chunk generation from Chunky and marshals reconciliation back onto the server main thread to atomically commit newly generated block entities to the world index.
  • GPU & Network Throttling:
    • Distance & screen-space prioritized budget limiter (projectedPixelSize * 1000 - distance) using bounded top-K selection (O(N log K)).
    • Bandwidth-throttled (128 KiB/tick) chunked multipart snapshot packet streaming (nearest-first) with atomic client-side assembly.
    • Ingestion-time payload pre-decoding: zero payload deserialization or ByteBuf allocation in the render loop.

🧩 Provider Architecture

Distant Decorations is designed as a modular core framework. Content mods register their own lightweight metadata providers on the server and custom renderers on the client:

Mod Integration Architecture
Really Fast Paintings Registers a painting provider and renderer leveraging vanilla atlas sprites with single-quad FAR LOD and far-LOD visual footprint scaling.

⚙️ Configuration & Diagnostics

Distant Decorations provides runtime diagnostics commands and system property configuration:

Diagnostic Commands
  • Client:
    • /ddc stats: Displays active configuration, synced region/decoration counts, and last-frame breakdown (Visible/Rendered, Far-LOD Scaled, Suppressed (Live), Culled (Distance), Culled (Subpixel), Culled (Frustum), and Culled (Budget)).
    • /ddc toggle: Toggles distant decoration rendering on or off at runtime.
  • Server:
    • /dd stats: Displays indexed decoration counts, loaded dimensions, active client subscriptions, and dirty region tracking.
    • /dd toggle: Master server toggle for decoration synchronization.
Configuration Properties
JVM Property Default Description
distantdecorations.subscription_radius_chunks 512 Client subscription radius in chunks (decoupled from vanilla render distance).
distantdecorations.min_projected_pixel_size 0.10 Global subpixel culling threshold in screen pixels (floored at 0.01).
distantdecorations.max_render_distance radius * 16.0 Absolute max rendering distance in blocks (defaults to 8192.0 at 512 chunks).
distantdecorations.disabled false Master kill-switch to disable DD processing.
distantdecorations.provider.<namespace>.<path>.disabled false Disables a specific decoration provider/renderer by identifier.
distantdecorations.provider.<namespace>.disabled false Disables all decoration providers from a given namespace.

🛠️ Developer API

Distant Decorations provides a clean, extensible API allowing third-party mods to register custom decoration types, server providers, and client renderers.

1. Define a Decoration Type & Provider (Server-Side)
public record MyCustomData(Identifier texture, Direction facing, int width, int height, int packedLight) {}

public class MyCustomProvider implements DecorationProvider<MyCustomData> {
    public static final DecorationType<MyCustomData> TYPE = new DecorationType<>(
        Identifier.fromNamespaceAndPath("mymod", "custom_deco"),
        (data, buf) -> {
            buf.writeIdentifier(data.texture());
            buf.writeByte(data.facing().get2DDataValue());
            buf.writeVarInt(data.width());
            buf.writeVarInt(data.height());
            buf.writeInt(data.packedLight());
        },
        buf -> new MyCustomData(
            buf.readIdentifier(),
            Direction.from2DDataValue(buf.readByte()),
            buf.readVarInt(),
            buf.readVarInt(),
            buf.readInt()
        )
    );

    @Override
    public DecorationType<MyCustomData> type() { return TYPE; }

    @Override
    public boolean matches(BlockEntity be) { return be instanceof MyCustomBlockEntity; }

    @Override
    public MyCustomData capture(ServerLevel level, BlockPos pos, BlockEntity be) {
        MyCustomBlockEntity custom = (MyCustomBlockEntity) be;
        return new MyCustomData(custom.getTexture(), custom.getFacing(), custom.getWidth(), custom.getHeight(), getPackedLight(level, pos));
    }

    @Override
    public AABB calculateBounds(ServerLevel level, BlockPos pos, MyCustomData data) {
        return new AABB(pos);
    }
}
2. Implement Client Renderer (Client-Side)
public class MyCustomRenderer implements DecorationClientRenderer<MyCustomData> {
    @Override
    public DecorationType<MyCustomData> type() { return MyCustomProvider.TYPE; }

    @Override
    public double cullBelowProjectedPixelSize() {
        // Opt into custom subpixel threshold for far-LOD scaling
        return 0.01;
    }

    @Override
    public void render(
        DecorationRecord record,
        MyCustomData data,
        Camera camera,
        PoseStack poseStack,
        SubmitNodeCollector submitNodeCollector,
        ProjectionMetrics metrics,
        double projectedPixelSize
    ) {
        BlockPos anchor = record.pos();
        Vec3 camPos = camera.position();

        poseStack.pushPose();
        poseStack.translate(anchor.getX() - camPos.x, anchor.getY() - camPos.y, anchor.getZ() - camPos.z);
        poseStack.translate(0.5, 0.5, 0.5);

        // Optional Far-LOD visual scaling for subpixel quads
        double targetMinPixelSize = 1.0;
        if (projectedPixelSize > 0 && projectedPixelSize < targetMinPixelSize) {
            double visualScale = Math.min(16.0, targetMinPixelSize / projectedPixelSize);
            poseStack.scale((float) visualScale, (float) visualScale, 1.0F);
            TelemetryMetrics.clientFarLodScaledRenders++;
        }

        RenderType renderType = RenderTypes.entityCutout(data.texture());
        submitNodeCollector.submitCustomGeometry(poseStack, renderType, (pose, buffer) -> {
            // Submit vertex geometry
        });

        poseStack.popPose();
    }
}
3. Registration
// Common / Server Mod Initializer
DecorationRegistry.registerProvider(new MyCustomProvider());

// Client Mod Initializer
ClientDecorationRegistry.registerRenderer(new MyCustomRenderer());

📦 Building & Testing from Source

git clone https://github.com/justbecauseph/distant-decorations.git
cd distant-decorations
./gradlew build

To run the full client test environment with Voxy, Sodium, and Spark preloaded:

./gradlew runIntegrationClient

The compiled mod JAR will be located in build/libs/.


📄 License

Distant Decorations is licensed under the Mozilla Public License 2.0 (MPL-2.0).

FAQ

Fragen zu Distant Decorations

Deine Frage fehlt? Frag unser Team.

Distant Decorations Server crasht beim Start – was tun?

Häufige Ursachen: Loader- oder Minecraft-Version passen nicht zur Mod-Datei, eine Abhängigkeit fehlt oder der RAM reicht nicht. Such im Log (latest.log) nach „OutOfMemoryError“, „Mixin“ oder fehlenden Mods. Bei Mado wertet die KI-Crash-Analyse das Log aus und schlägt eine Ursache vor. Loader und Version änderst du im Panel.

Mit welchem Loader läuft Distant Decorations?

Laut Modrinth unterstützt Distant Decorations Fabric für Minecraft 26.3, 26.2.

Wie viel RAM braucht ein Server mit Distant Decorations?

Als Orientierung 3–4 GB für einen Server mit dieser Mod. Das ist eine Schätzung, keine gemessene Mindestanforderung. Weitere Mods, viele Spieler und große Sichtweiten brauchen mehr. Ob eine Mod die Tick-Zeit belastet, siehst du mit dem spark-Profiler.

Bereit für deinen Server mit Distant Decorations?

4 GB RAM ab 8,00 € im Monat. 35 % auf den 1. Monat mit MADO35.

Server bestellen