Skip to content

uberswe/CreateSchematicUpload

Repository files navigation

CreateSchematicHelper

CreateSchematicHelper

A Minecraft mod for uploading and downloading Create mod schematics via createmod.com.

Build GitHub Release Modrinth Downloads CurseForge Downloads License


Features

Upload

  • Automatic upload - schematics are uploaded to createmod.com the moment you save them in-game
  • 360° preview rendering (NeoForge 1.21.1+ only) - 120 isometric frames are rendered client-side and uploaded alongside the schematic for an interactive 3D rotation view on the website
  • Progress bar (NeoForge 1.21.1+ only) - a live progress bar on the action bar tracks rendering, processing, and uploading stages
  • One-click sharing - a clickable link appears in chat so you (or anyone) can view the schematic in a browser
  • Claim flow - log in on the website to claim ownership, then publish to the community
  • Optional confirmation - disable auto-upload in the config to get a confirmation screen before each upload
  • No account needed in-game - uploads are anonymous; you claim them on the website when you're ready

Download

  • Download from createmod.com - enter a createmod.com URL or short code directly in the Create Schematic Table to download schematics shared by other players
  • Seamless integration - downloaded schematics are placed into your local schematics folder and are ready to use immediately

Side

This is a client-side only mod. It does not need to be installed on the server.

Supported Versions

Branch Minecraft Loaders Create Java 360° Viewer
main / mc/1.21.1 1.21.1 NeoForge, Fabric 6.0.10+ 21 Yes
mc/1.20.1 1.20.1 Forge, NeoForge, Fabric 6.0.8+ 17 No
mc/1.19.2 1.19.2 Forge, Fabric 0.5.1+ 17 No
mc/1.18.2 1.18.2 Forge, Fabric 0.5.1+ 17 No

Note: On 1.20.1 and below, schematics are uploaded without preview images. The 360° rotation viewer and progress bar are available on NeoForge 1.21.1+ only.

Installation

  1. Install the mod loader for your Minecraft version (NeoForge, Forge, or Fabric)
  2. Install the Create mod
  3. For Fabric: install Fabric API
  4. Drop the CreateSchematicHelper .jar for your loader into your mods/ folder
  5. Launch the game

Configuration

NeoForge / Forge: config/createschematichelper-client.toml Fabric: config/createschematichelper.json

Option Default Description
enabled true Enable or disable the upload feature entirely
autoUpload true Upload automatically on save (if false, a confirmation screen is shown)
baseUrl https://createmod.com API base URL
render360 true Render 360° rotation view (disable for faster uploads with only 4 featured angles) (1.21.1+ only)
frameCount 120 Number of frames in the 360° rotation view (min 4, max 720) (1.21.1+ only)
aspectRatio 16:9 Aspect ratio for rendered images (e.g. 16:9, 4:3, 1:1) (1.21.1+ only)
overrideWidth 0 Override image width in pixels (0 = automatic based on schematic size) (1.21.1+ only)
overrideHeight 0 Override image height in pixels (0 = automatic based on schematic size) (1.21.1+ only)
saveFeaturedFrames false Save the 4 featured perspective images locally to the schematics folder (1.21.1+ only)
saveAllFrames false Save all rotation frames locally to the schematics folder (1.21.1+ only)
imageFormat jpeg Image format for rendered frames: jpeg (smaller files, recommended) or png (lossless) (1.21.1+ only)
backgroundImage (empty) Absolute path to a custom background image (JPEG or PNG). Leave empty to use the default blueprint grid. (1.21.1+ only)

How It Works

Uploading

  1. Save a schematic using the Create mod's Schematic and Quill
  2. On NeoForge 1.21.1+, the mod renders 120 isometric preview frames (a progress bar tracks each stage)
  3. The .nbt file (and preview images on 1.21.1+) are uploaded to createmod.com
  4. A clickable link appears in chat
  5. Visit the link and log in to claim the schematic as yours
  6. From there you can publish it to the community

Downloading

  1. Open the Create Schematic Table
  2. Toggle to URL download mode
  3. Paste a createmod.com schematic URL or short code
  4. The schematic is downloaded and saved to your local schematics folder

Building from Source

git clone https://github.com/uberswe/CreateSchematicUpload.git
cd CreateSchematicUpload
./gradlew build

JARs are produced per loader:

  • neoforge/build/libs/ - NeoForge JAR
  • fabric/build/libs/ - Fabric JAR

Project Structure

This is a multi-loader project following the MultiLoader-Template pattern:

common/    - Shared code (config, upload/download handlers, rendering, mixins, GUI)
neoforge/  - NeoForge entry point, config, and platform-specific mixins
fabric/    - Fabric entry point and config

Credits

Modpacks

You are free to include this mod in any modpack that is distributed for free. Selling this mod or charging money for access to it (or any modpack containing it) is not permitted.

License

See LICENSE for details.

About

Automatically uploads schematics to CreateMod.com

Topics

Resources

License

Stars

Watchers

Forks

Contributors