search

maximuslotro / SignStory

A Minecraft mod for easily copying stories from a txt file onto signs.
GNU Lesser General Public License v3.0
4 stars 1 forks source link
forge minecraft minecraft-mod mod

readme

release downloads license

Sign Story

Minecraft 1.7.10

Table of Contents

Downloads

Downloads can be found here on github.

Downloads can be found here on CurseForge.

About

Ever wanted to place many signs in a row with text being supplied from a txt file? Well look no further. This mod's aim is to allow users to create stories with signs in Minecraft. It also perserves all the functions of the original SignPicture Mod and is like an updated and maintianed version of it.

Installation

You install this mod by putting it into the minecraft/mods/ folder. It has no additional hard dependencies.

Issues

SignStory crashing, have a suggestion, found a bug? Create an issue now!

  1. Make sure your issue has not already been answered or fixed and you are using the latest version. Also think about whether your issue is a valid one before submitting it.
  2. Go to the issues page and click new issue
  3. Enter your a title of your issue (something that summarizes your issue), and then create a detailed description of the issue.
    • The following details are required. Not including them can cause the issue to be closed.
      • Sign Story version
      • Crash log, when reporting a crash (Please make sure to use pastebin)
        • Do not post an excerpt of what you consider important, instead:
        • Post the full log
      • Other mods and their version, when reporting an issue between Sign Story and another mod
        • Also consider updating these before submitting a new issue, it might be already fixed
      • A detailed description of the bug or feature
    • To further help in resolving your issues please try to include the follow if applicable:
      • What was expected?
      • How to reproduce the problem?
        • This is usually a great detail and allows us to fix it way faster
      • Screen shots or Pictures of the problem
  4. Click Submit New Issue, and wait for feedback!

Providing as many details as possible does help us to find and resolve the issue faster and also you getting a fixed version as fast as possible.

Building

  1. Clone this repository via
    • SSH git clone git@github.com:maximuslotro/SignStory.git or
    • HTTPS git clone https://github.com/maximuslotro/SignStory.git
  2. Setup workspace
    • Decompiled source gradlew setupDecompWorkspace
    • Obfuscated source gradlew setupDevWorkspace
    • CI server gradlew setupCIWorkspace
  3. Build gradlew build. Jar will be in build/libs
  4. For core developer: Setup IDE
    • IntelliJ: Import into IDE and execute gradlew genIntellijRuns afterwards
    • Eclipse: execute gradlew eclipse

Contribution

Before you want to add major changes, you might want to discuss them with us first, before wasting your time. If you are still willing to contribute to this project, you can contribute via Pull-Request.

Here are a few things to keep in mind that will help get your PR approved.

Getting Started

  1. Fork this repository
  2. Clone the fork via
    • SSH git clone git@github.com:<your username>/SignStory.git or
    • HTTPS git clone https://github.com/<your username>/SignStory.git
  3. Change code base
  4. Add changes to git git add -A
  5. Commit changes to your clone git commit -m "<summery of made changes>"
  6. Push to your fork git push
  7. Create a Pull-Request on GitHub
  8. Wait for review
  9. Squash commits for cleaner history

If you are only doing single file pull requests, GitHub supports using a quick way without the need of cloning your fork. Also read up about synching if you plan to contribute on regular basis.

License

Credits

Thanks to