Public Repository for the Magicbane Shadowbane Emulator
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
FatBoy-DOTC 657cc0cf9e Cannot Abandon Tree if You Own a Bane : Cannot Abandon Tree if you are a nation 3 years ago
src Cannot Abandon Tree if You Own a Bane : Cannot Abandon Tree if you are a nation 3 years ago
.gitignore Initial commit 3 years ago
LICENSE Update to README.md and LICENSE 3 years ago
README.md Update 'README.md' 3 years ago

README.md

Logo

Magicbane Open-Source MMO Project

The Community written Shadowbane emulator

Magicbane
Public Repository
magicbot@magicbane.com

Magicbane is an emulator for the long dead but much beloved Ubisoft MMO, Shadowbane. The project was founded in 2013 with the concept of free availability of gameplay; players unencumbered by any factor other than a desire to again play a game they once loved. A game where the developers do not play is guaranteed to be the fairest game.

The Magicbane Team has wanted to open source Shadowbane for half a decade. We are excited to now finally have the opportunity, along with some new technology, to truly democratize Shadowbane.

  • Written in some 80k lines of Java 8 and bash.
  • Project with real infrastructure; Production and development servers supporting multiple containerized apps.
  • MagicBox container technology enables instant deployment and trouble free development on modest hardware.
  • MagicBox plugin capability allows for new and interesting player experiences.

Contributing

  • Inbound == Outbound.
  • IntelliJ is the supported IDE.
  • Write code today see it running on the Magicbane production server tomorrow.

Project setup

Prerequisites:

Copy the HTTP link if you haven't yet installed a public key:

CopyUrl

  • Clone the Magicbane public repo to your local machine using the copied URL.

CloneURL

  • Under Settings->VersionControl->Git make sure to turn off these two settings.

CommitOff

  • Select the Project Structure settings within the IDE.

ProjectStructure

  • Select Java 8 as the IDE target as shown.

Java8

  • Delete and recreate content root pointing at the Server directory.
  • Make sure the Language Level still reflects Java 8.
  • The IDE should now autodetect the cloned source.

hmm

Magicbane currently has the following dependencies.

They are all directly obtainable from a running MagicBox instance.

docker cp magicbox:/usr/share/java/EnumBitSet.jar Dependencies/

Add the jar files as project libraries as shown.

Libs

You should now be able to build the game!

Build

Next Steps

You can now move onto the Development Workflow or MagicBox Setup pages for further information.

Support is also available through the Magicbane Discord server. Feel free to stop in and pick Magicbot's brain!