Configuration - ShadowJonathan/ByteCart GitHub Wiki

There are 3 levels of configuration:

  • Region: configuration specific to a region, must be repeated in each region
  • Local: Configuration of subrings and stations in a specific region
  • Backbone: Configuration of the backbone

Region level configuration must be done first, then local level configuration.

Backbone level configuration must be done when all region level configurations are done.

Before proceeding

Dynmap

ByteCart implements the support of Dynmap, and fills a specific layer with stations. It is an inestimable help when configuring a network. It is strongly advised to use dynmap during configuration.

Dynmap should be already installed before beginning configuration.

BCProtect

Configuration is a very sensitive operation that should not be interrupted by mobs, animals, carts or players on the network. BCProtect has a lot of features to protect the network. Even if you don't plan to use BCProtect plugin, it is a good idea to install it during configuration.

Tests

You should have performed some visual tests with the command /bcupdater reset_local before configuring the network. The reset local updater is a cart that go randomly in rings, and visit all subrings. It should not stay in a loop or stop in a stations. If the reset local updater behaves normally, the network is ready for configuration.

If the local updater has a abnormal behaviour, it is probably a construction problem. some console errors may appear.

First configuration

Before

Take care that no one can disturb the configuration. All works must be finished or postponed. Mobs and animals should be disallowed if possible.

Execution

Go to the track near the garbage collector, face to the BC8010 sign. Put a storage cart on the track.

Type /bcupdater region n new where n is the region number you choose between 1 and 2047.

Push the cart so that it passes on the BC8010 sign. The sign will be updated with address n.0.0.

Let the cart cross the router. If it does a U-turn, there is a problem. Check errors in console.

The cart should run in all the rings and update address on BC8010 signs. The same address will be set for the two BC8010's at each end of a track. Two distinct rings must not have the same address.

When all BC8010 signs have been filled, the network is useable, but configuration is not finished.

The cart will run until an automatic timeout. Don't stop it before it has finished its job.

When the timeout is reached, a message will be displayed in the chat window of the player who has launched the updater, in the console otherwise.

After

Check that there is no error message in console. If possible, make a visual review of each BC8010 signs to check they have received a unique number and that the same number is reported on the other end of the track.

To test the configuration, check that an empty storage cart will take the shortest path to go to garbage collector, from anywhere it starts.