Description

This is a mobile home inside of a refurbished bus. It can travel between 50 predefined locations across the Commonwealth, Nuka-World, and Far Harbor, as well as to exterior settlements.

Features

The bus can travel to certain predefined locations. By default, you need to unlock these locations by visiting them. A message should appear as you enter the area. You can also unlock all of them through the Settings at the Navigation System terminal if that's how you want to play.
In addition, you can also build Bus Arrival Markers at your settlements. This allows the bus to travel to these locations as well. The marker will be visible in workshop mode only.

If F4SE is installed, the list of destinations will be sorted alphabetically, otherwise it will be in the order of discovery.

Requirements

This mod requires either WorkshopFramework or Settlement Menu Manager in order to inject it's custom workshop menu.

Usage

You can initially find the bus at Lexington bus station (compatible with Tales from the Commonwealth!)
First, you will need to refuel the bus. It runs on Fusion Cores, add them using the console below the Navigation System. Each Fusion Core adds 10 units of Charge, up to 100 (or more, if you upgrade the battery).

Then, you need to unlock locations to travel to. See the three maps under Screenshots where they are located. The locations unlock as soon as you walk through them.
Alternatively, you can use the Settings in the Navigation System Terminal to unlock them all right away.

Use the Navigation System at the front of the bus to select a destination from the list. Don't forget to select "Start Navigation"! Activate the Driver's Seat to begin travelling.

Destinations can also be marked as favorites. A new Favorites menu will appear in the Navigation System if you do this.

If you are outside, you can also call the bus to the closest unlocked bus stop using the Bus Remote. Craft one from a Bus Workbench from under Utility, and use it from your inventory, it will be under AID. Or bind it to a hotkey.

Within the bus, you can use workshop mode. The workshop itself is the orange toolbox attached to the wall next to the driver's seat.
Most pre-placed objects can be scrapped. Some of them can be rebuilt, and will snap into the bus. The workshop menu for this will be unlocked when you first enter the bus.
The power source is the outlet next to the bus entrance. It can be moved, like the Fusebox in Home Plate.

To be able to travel to a settlement, build the Bus Arrival Marker there. It will become invisible when you exit workshop mode.
In addition, you can also build a Charging Station. It requires 50 power, but, when powered, it will fully recharge the bus as soon as it enters the settlement.

Customization

The bus can be customized in several ways. Most of the customizations are purely cosmetic, but some also affect the bus in some way.
Use the Bus Workbench, either within the bus, or build one in a settlement to install customizations.

These options are available by default:

Battery
The batteries do not affect the bus visually in any way, but they change how much charge the bus can store. 

Driver
This is the piece you activate in order to trigger the driver. It goes in the front left on the inside.
You have the choice between robotic drivers, and an empty seat, in case you want to RP that you are driving yourself.

Exterior Skin
Changes how the bus looks from the outside, a paint job. You can choose between the default bus, the schoolbus, or the Nuka-World tour bus.

Interior Skin
Changes how the bus looks from the inside. This essentially just changes the color on some of the wall pieces. There are the same options as for the exterior skin.

Front Addon
Objects on the front of the bus.

Headlights
Affects how the headlights look like. Turn them off, make them glow a bit, or turn them into proper lights.

Rear Addon
Objects on the back side of the bus.

Sides Addon
The sole option here are the Workshop Access Hatches. They allow you to access the inventory of the interior workshop from the outside.

Top Addon
Objects on the roof of the bus.
The only non-cosmetic option here are the Solar Panels: they slowly recharge the bus, generating 1 charge per day.

Wheels
Wheels, threads, rocket thrusters, or a hovercraft conversion. The latter two are somewhat noisy.

Settings

You can customize some behavior and the mod's difficulty by accessing the [Settings] entry in the Navigation System terminal.

• Follower Handling: whenever to allow followers to enter the bus.
  By default, it will only allow "small" followers to enter (a whitelist containing Humans, Ghouls, Children, robots except Sentries, dogs, and some other animals)
• Power Usage: adjust the power drain to travel, or turn it off alltogether, making travelling free.
• Refresh Bus: in case some customization pieces misspawned, you can refresh it here.
• Register As Settlement: you can, technically, turn the bus into a full settlement.
  WARNING: Not only can't this be reversed, removing the mod afterwards will break your game!
• Resource Sharing: only available if the bus has registered as settlement. It can automatically create supply lines to either the settlement it's currently in, or the closest one.
  

Settlement Objects

Once you enter the bus, various settlement objects will become availabe. Most importantly, these include the Bus Arrival Marker, which, when built, allows the bus to travel to it. Only one is allowed per settlement.
Another important piece is the Charging Station. If powered, it will fully recharge the bus, once it arrives at the corresponding settlement.
There are also some decorative objects, the small workbenches from the interior of the bus, as well as a larger exterior version of the Bus Workbench.

Limitations

The number of possible bus stops is limited to 126, due to engine limitations.

Compatibility

This mod can be put at the very top of your load order. It may safely lose any cell edit conflicts.

If you have settlement mods at any of the predefined bus stops, they should be able to recognize this the next time you visit the location, and become visible and movable in workshop mode. This should also work for SS2's conquerable territories.

For mods with settlements in new worldspaces, the distance calculations will not work properly. Compatibility patches would be necessary.

Mods which replace the textures or materials of the vanilla bus will also affect this bus.

Mods which alter the area around any of the predefined bus stops would cause conflicts and require patches. No such mods are known at the moment of writing.

The mod is somewhat extendible. Neither the locations nor the customization options are hardcoded, and more can be added via mods. See this article for more details. A knowledge of the Creation Kit is required.

Credits

The interior of the bus was made by Elianora
The Bus Driver Protectron and Hat were made by Captain-Ultima
The D.C. City Liner skin was made by and is used with permission from ScottyX2
The Pre-War and Vault-Tec skins* were made by and are used with permission from ValeraPan (with minor tweaks to the Vault-Tec skins)

CHECK OUT MY OTHER MODS HERE