/Fiddle

A fork of Paper that supports adding custom blocks, items and more.

OtherNOASSERTION

Gale logo

Fiddle

A Paper server fork that lets you
add custom blocks and items

Discord

Pictures from the version currently running live on the server ip sucraft.org

Introduction

Fiddle is a Paper server fork that lets you add new blocks and items into Minecraft.

Fiddle:

  • works with (existing) Bukkit plugins1
  • adds blocks and items into the game in the same way a Minecraft update would
  • adding new blocks and items is simple using the standard resource and data pack format
  • allows Bukkit plugins to add and use custom blocks and items when on a Fiddle server

You are very welcome to help with implementation, testing, sharing knowledge or giving suggestions.

Installation

Fiddle is a drop-in replacement for Paper.
You can download the latest development JAR from actions.

After running Fiddle once, you must open fiddle.txt, read the warning carefully, and set modded=true.

🔨

 Note: Fiddle is in active development.
Some of the information below may be outdated or incorrect.
Do NOT run Fiddle on a production server!

Adding/creating blocks/items

New content to add to the game, like blocks and items, are loaded by Fiddle from packs, similar to resource and data packs.
A pack is a .zip or .rar file. To install a pack, you can place it in the fiddle_packs folder in the server root.
Example location: fiddle_packs/WillowTrees.zip

You can download packs made by others, or create your own packs and share them.

Bukkit plugins can also add custom blocks and items.

Demo

An experimental version of Fiddle is already running on a small community server.
You can join sucraft.org and do /warp Demo to see it in action yourself.

Goals of the project

Supports any player

  • A client mod that supports the custom blocks and items directly
  • A resource pack that allows vanilla clients to see the custom blocks and items
  • Players do not have to accept the resource pack, and will be shown custom blocks and items as closely as possible

Seamless updates

Mods adding custom blocks frequently have the problem that they break with a new Minecraft version, and then sometimes stop being updated.

The blocks and items added to a Fiddle server do not need to be updated, and always remain saved in the world and loadable, placeable and breakable as before.

Works with plugins

Custom blocks and items work fully with Bukkit plugins out of the box.

Architecture

Acknowledgements

This project has been made possible by:

  • the generous donation from Janet Blackquill
  • the authors and maintainers of the Bukkit, Spigot and Paper projects
  • everyone on GitHub and the Discord server who helps test Fiddle and provide feedback and suggestions

Footnotes

  1. Some older plugins have still not updated to use 1.13+ namespaced ids. These plugins can still be used on Fiddle, but require having backwards compatibility mode enabled. ↩