Giter VIP home page Giter VIP logo

better-printer's Introduction

Litematica Printer

GitHub issues GitHub pull requests GitHub all releases GitHub Repo stars

This extension adds printing functionality for Litematica fabric 1.19, 1.18 and 1.17 versions. Printer allows players to build big structures more quickly by automatically placing the correct blocks around you.

Demo

Installation

  1. Download and install Fabric if you haven't already.
  2. Download the latest release for your Minecraft version from the releases page.
  3. Download Litematica + MaLiLib and Fabric API.
  4. Place the downloaded .jar files in your mods/ folder.

If this is the first fabric mod you are installing, here's an informative video on how to install Fabric mods.

How To Use

Using the printer is straightforward: You can toggle the feature by pressing CAPS_LOCK by default. To configure variables such as printing speed and range, open Litematica's settings by pressing M + C and navigate to "Generic" tab. Printer's configuration can be found at the bottom of the page. You can also rebind the printing toggle under "Hotkeys" tab. Holding down V by default will also print regardless if the printer is toggled on or off.

Issues

If you have issues with the printer, do not bother the original creator of Litematica (maruohon) with them. Contact me instead. Feature requests or bugs can be reported via GitHub issues, or in Discord. I'll try to keep a todo list of things I'm planning to implement and fix, so please look for duplicates there first.

Before creating an issue, make sure you are using the latest version of the mod. To make fixing bugs easier, include the following information in your issue:

  • Minecraft version
  • Litematica version
  • Printer version
  • Detailed description of how to reproduce the issue
  • If you can, any additional information, such as error logs, screenshots or the incorrectly printed schematics.

List of know issues

Currently, the following features are still broken or missing:

  • Placing liquids (printing in liquids works though)
  • Printing without support directly in air (printInAir)
  • Current algorithm for placing rails isn't perfect, sometimes it can't place all the rails (to avoid placing anything incorrectly).
  • Legit mode? (for anticheats)

Also, I have decided that features that fix existing builds, such as automatic excavation or correcting incorrectly placed blocks are out of the scope of this mod.

Building and Contributing

Each Minecraft version has its own submodule, that has the default fabric mod development tasks and contains the version-specific code. To reduce the amount of work I have to do to make it work for multiple Minecraft versions, I created this hacky gradle script that copies the common code over to the other version implementations. Currently, the script copies everything, except implementation/ folder, which should therefore be the only places containing any version specific code.

If you want to make changes to the mod, I would recommend you to first implement them for the latest Minecraft version (1.19), and then running the syncImplementations gradle task, found in the same subproject as your changes, to copy the common code of that submodule to the other implementations. After that you will only have to write / copy manually the version-specific code (found in the implementation folder) to the other versions and do some testing to ensure everything works.

Contributions are welcome and appreciated! I have recently rewritten the whole project, so that it would be much easier to work with.

Also, if you know a better way to develop for multiple Minecraft versions that doesn't involve multiple git branches or hacky gradle scripts (perhaps a way to share common code between the implementations?), please let me know.

Useful gradle tasks:

  • [v1_19/v1_18/v1_17]:syncImplementations
    • Copy over common code to other implementations
  • buildAll
    • Build all implementations and copy their jars to build/ directory for easy distribution.
  • [v1_19/v1_18/v1_17]:runClient
    • Start the target Minecraft version

better-printer's People

Contributors

aleksilassila avatar byquanton avatar jensvh avatar johannes7k75 avatar kafuuchino-desu avatar kaisomir avatar maruohon avatar stanuwu avatar vacla avatar warmbroke avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.