Polska wersja
MaSzyna - Railway Vehicle Simulator EP07-424

"MaSzyna" Simulator

The Readme File

AUTHOR: libertyn89

UPDATE: kolejarz2009, Stele, matek123, Vanquish, Kogut

CONSULTATIONS, HELP: adsim, Benek, dejotzbych, EP08_015, hunter, Maciej, matek123, Ra, Sawi,
sebastian82, Stele, surgeon, szogun, youBy,
Turbokibel, Toprus and others
TRANSLATION: kolejarz2009, Vanquish, Kogut


Contents

  1. Introduction
  2. Information about this release
    1. Package contents
    2. New EXE features
    3. New content
  3. Health warnings
  4. I've downloaded the simulator, now what?
    1. Hardware requirements
    2. Installing
    3. First run - Starter.exe
    4. Uninstalling
  5. Key controls
  6. User info
    1. Controlling
    2. Changing cabs
    3. Coupling and uncoupling the locomotive
    4. How to change the consist in the scenario?
    5. How to change the weather and season?
    6. How to set the multiplayer up?
    7. How to set the OpenVR support?
  7. Remarks
    1. Why is ... not included in this pack?
    2. Simulator executable – EXE changes
  8. What next? When is a new version / new add-ons comming out?
  9. The Simulator's Licence
  10. FAQ – Frequently Asked Questions. Most common problems and their solutions
  11. Official adresses and contact
  12. Translator's Note

Introduction

The "MaSzyna" Simlator project has grown of age, as it's been nearly 21 years since it's first publication. On the www.eu07.pl/jeszczejedensymulatorek subpage, we present a copy of the orignal thread from the August 2001, where the first version of MaSzyna has been presented.

We highly recommend you to try out the newest version of The "MaSzyna" Simulator.
eu07.pl Administration

Contents

Contents of the latest release

Current version of MaSzyna is based on previous versions of the Simulator. The list of all the previous releases, along with a short description, can be found here: [In Polish - use Google Translate] Zestawienie wydań Symulatora MaSzyna [List of previous releases].

Package contents

Because there is so many people working on MaSzyna, this information was moved to a separate subpage, in order to ease the updating of information.

Improvements and new EXE functions

Important notice

Activation of the cabin is possible by clicking with mouse on a dedicated switch in the cabin of the traction vehicle selected by the user or combination Ctrl+j.

More inforation you will find in control instruction.

The points above represent only a small fraction of changes, since these are the biggest and most visible to the users. Precise Changelog is in the following forum thread about changes in the EXE [POLISH ONLY!], the list is still updated as the EXE functions are expanded or on webpage.

What's new in the current release

Notwithstanding the above, the latest release also includes new vehicle textures, sounds, models, and a number of minor and major fixes to individual models, sceneries or scenarios that have been detected since the previous release.

Contents

Health warnings

Warnings for users of computer games

A small fraction of people can experience epileptic attacks because of the observed visual effects, such as blinking lights or multicolour compositions durning the observation of the computer screen. Even people without such symptomps can have undiagnosed diseases that cause epileptic attacks.

Attacks can occur in a variety of different ways: vision disorders/problems, headaches, muscle and/or eye lid twitching, uncontrolled motion of leg and arm muscle.More serious problems that can occur, are: desorientation, loss of balance, headaches, unaware movements, reddening of the eyes, eye tears, tiredness of eyes. There is a risk of a fall and serious injury can occur. The biggest risks affect mainly children and teenagers, and as such, parents should observe the children whilst they play on the computer.

Recommendations: Always play in well lit room, make a 15min pause, for every 60min spent in front of the computer and rest untill the discomfort disappears, don't sit too close to the screen, don't play if you're experiencing feelings of discomfort or tiredness. If you or your family have a history of epileptic attacks, please consult a doctor before playing.

Contents

I've downloaded the Simulator, now what?

Hardware requirements

The software and hardware requirements hare been increased in comparison to the previous versions. Because of the EXE file being supplied in both 32bit (x86) and 64bit (x64), caution should be exercised when picking and running the EXE file and it's dependencies on your computer.

The new renderer (supporting GL3.3+, with loads of new graphical features) has been implemented into the main binary, and as such, you will have to test if the new render works well on your PC - if it does not, select the rendering mode appropriately - you can set it in the Graphics tab in the Starter app, or in the eu07.ini file, by replacing the entry "gfxrenderer full" with "gfxrenderer legacy", for medium computers, be "gfxrenderer simple" for the weak.

Contents

Installing

The installation process and the appearance of each windows may vary depending on the user's hardware and software configuration.

  1. Run the installer of the program by using the file downloaded from the official website of the simulator: MaSzynaXXXX.exe, where XXXX is the number of the simulator release that you have downloaded.
  2. In the installer window that appears, set the program installation folder by entering the path of the destination folder or selecting it from the directory tree by clicking Przeglądaj / Browse.

  3. Screen 1: The main window of the MaSzyna installer
Important Notice

It is not recommended to install the program into system folders where X is the letter of the system drive:
That could cause numerous errors with access to folders and in extreme cases it will prevent the program from being properly installed.
  1. After selecting the destination folder, click Dalej / Next.
  2. In the next window that appears, please select the components that you want to install with the program. In most cases, you should choose the options selected by default. On the other hands you should install UCRT libraries, if you do not have them in your system.

  3. Screen 2: Additional functions selecting window

  4. Confirm the choice by clicking Zainstaluj / Install.
  5. In the case of operating systems with an active Firewall, an alert window regarding the aria2c.exe application features may appear during installation. To allow further installation, click Zezwalaj na dostęp / Allow.

  6. Screen 3: Firewall alert window

  7. Installation of the program should begin. Depending on the speed of the Internet connection and the parameters of the disk on which the program is installing, the installation time may vary.

  8. Screen 4: Installation process window

  9. When the installation is completed, click Zamknij / Close.

    Screen 5: Installation completion window

  10. We are ready for the first launch of the MaSzyna Simulator.

First run - Starter.exe

To turn MaSzyna on, we need to run the Starter.exe file, located in the main MaSzyna folder.

After activating the Starter, we'll see the window - at it's top pane four buttons: Scenarios, Depot, Settings and "?".

To change the Starter into English, go to "Ustawienia" pane, then in the "Ogólne" subpane, and change the "Język: [PL]" into "EN".

The Depot button allows for changing of trains on the scenarios, and will be described further on in the documentation, the Settings allow for changing of the simulation's settings, whilst ? opens the menu of your choice: can be opened readme file (the one you're currently reading) in a new browser window, or the current train instructions - we recommend that you read them before starting the game.

After initialising, a list of sceneries - "maps" - will be shown (point [A] on the pictures). After clicking the "+" by the desired scenery, a list of available scenarios - "missions" - for the selected scenery is shown. "baltyk_skm1" is selected in the picture.

In the [B] window, is a list of available vehicles for that scenario. After choosing one, say EN57AL-1230...

Window [D] will display the duty description, for the selected vehicle. No description might, but not necessarly will indicate that the selected train is for the AI (driven by the computer) only.

Window [C] shows general info about the scenario, and in the other panes the timetable (for the selected train in [B]), attachments like written orders and at the very end weather settings.

The button marked with [E] is used to hide archival scenarios, useful mainly for people with weaker devices – they are distinguished by weak decorations, low use of 3d decorative objects or low complexity of terrain and track layouts - otherwise it is recommended to play on scenarios marked as sceneria dobrej jakości - dla mocnych komputerów or sceneria średniej jakości.

In case of the Cloudiness slider, the first (left) half is responsible for cloudiness, and the other (right) for precipitation.

When you're ready to start the simulation, press Start, in the [X] field.

Next, a window will appear, with the simulation's loading bar. Windows can indicate that the program is hanged/not-responding, but that is not the case. Most of the sceneries are detailed, and as such will result in very slow loading times on slow computers.

Uninstalling

To uninstall, please delete the main Simulator folder, along with all of it's contents from the computer's drives. Sometimes, you might also need to delete it from the Bin folder. Please use the Empty Bin function.

Contents

Keyboard Control

Important notice

The key presented in this chapter has a default assignment.
Using the Starter.exe it is possible to change the keys at your own idea.
Go to the site containing Keyboard Contols.
Contents

Control

Controlling, or the popular "How to move the loco?" and others.


The procedure for starting each vehicle is the same - only the control keys change!
Important notice

The key presented in this chapter has a default assignment.
Using the Starter.exe it is possible to change the keys at your own idea.
Go to the site containing the driving and start up procedures.
Contents

Changing Cabs


In order to move to the other cab, press either:
ATTENTION!
In between the cabs, is the Engine Room (in some locos, it looks like a green room). If you are in the Engine Room, then press either Home or End (depending on the direction in which you plan on going) for a second time. When changing cabs in Electric Multiple Units (EMUs) and locos that have more than one unit, you will need to press End or Home a couple of times (for example, in EN57 we press End twice, to move from Ra (Driving Trailer A) unit, to unit S (Motor Coach), and then End three times, in order to move to Rb (Driving Trailer B) unit, and then finally press End twice, to enter the cab). Changing cabs means that the Sim need to load it's model, that's why after pressing Home or End it is necessary to wait (for it to load).

ATTENTION!
If we are driving a vehicle in Multiple Working, or it is a double-unit loco, or a EMU, it is important to check if both the Independant and the Loco brake is in the Running position ("brake off"). We also should set the Train Brake to Cut-off position (Ctrl + Num 5).
Contents

Coupling and uncoupling


COUPLING UP A LOCO TO THE CARRIAGES:
  1. Drive up to the train (don't leave the cab), when you feel that you buffered up (Drove up to the buffers, and slightly hit them), move the throttle up 2-3 positions, and brake using the Independant Brake (reminder: Num 1).
    WARNING!: If, when buffering up, the carriages "run away", then leave the cab, F4 fly up to two, three carriages and brake them using the Handbrakes, holding Ctrl + Num 1. When you are done with the whole coupling-up precedure, fly up to those same carriages, and hold Ctrl + Num 7 in order to release the handbrakes.
  2. Exit the cab - F4.
  3. Get as close to the coupler as possible - imagine you are coupling them up yourself. It's not enough to come close vertically, you also need to move horizontally. In majority of cases, you should also lower you self a little bit by using PageDown.
  4. Press Insert twice - you will hear the characteristic air leak sound and a model of a coupled-up screw-link coupler will be shown, along with the "red hose".
    If you, additionally, want to connect the Main Reservoir Pipe ("Yellow hose") then press Insert once more.
    WARNING: Sometimes, the coupler and the hoses won't move, it doesn't mean that the loco has not connected up to the carriages.
  5. Go back to the cab - F4.
  6. Unbrake the loco - Num 7 and go to the other cab.
UNCOUPLING A LOCO FROM THE CARRIAGES:
  1. Brake the whole train, pressing the Num 3 for around one second, from the Running position.
  2. Unbrake the loco only - Num 6.
  3. Move the Reverser backwards by 2 positions (2 x r) and select the 2nd or 3rd position on the Power Controller, to buffer up to the carriages, and brake using Independant brake (rem.: Num 1).
  4. Exit the cab - F4.
  5. Get as close to the coupling as possible - imagine you are uncoupling them yourself. It's not enough to come close vertically, you also need to move horizontally. In majority of cases, you should also lower you self a little bit by using PageDown.
  6. Press Delete once - you will hear the characteristic air leak sound.
  7. Go back to the cab - F4.
  8. Unbrake the loco - Num 7.
COUPLING UP TO A TRAIN THAT ALREADY HAS A LOCO:

To couple up to a train on the same track, drive up to it gently. After you buffer up, brake using the Independant brake. In order to prevent a runaway train, it is vital that you perform a Full Service brake application or at least a Service brake application (Num 8).

ATTENTION!
If your train is to be coupled up to a train driven by AI, (ie. you drive a Banking Engine or the AI hauls your train ), then it is absolutely necessary to set the Train Brake to the Cut-Off position (Ctrl + Num 5)!
If the user is to drive the train, then the Train Brake valve must stay in the braking positions, and the Reverser must be in either the forward or backward position. This deactivates the AI !!. After the above has been completed, one can now start to couple the couplers with Insert. The moment the coupler is connected (after the first Insert key press ) AI "being" in the set is either deactivated (Train brake in the braking positions) or it's activated (Train brake in the Cut-Off position). If you make a mistake (choose wrong action), then decouple, set the Train brake in the correct position, and try to couple up again.

COUPLING A LOCOMOTIVE TO A UNIT (WITH THE USE OF A COUPLING ADAPTER):
  1. Drive up to the train but stop between 25 m and 5 m from it.
  2. Get out of the cab and move to the coupler facing the unit we will couple up to.
  3. Put on the coupling adapter - Ctrl + Insert
  4. Drive up slowly, and push up gently and slowly against the coupler on the unit.
  5. Check if the couplers locked together - try to drive away from the unit.
UNCOUPLING A LOCOMOTIVE FROM A UNIT (WITH THE USE OF A COUPLING ADAPTER):
  1. Brake the train set - Num 3 x 1sec.
  2. Uncouple the automatic coupler and the adapter - Delete
  3. Move off between 2 m and 25 m from the unit, and take the adapter off - Ctrl + Delete
Contents

How to change the consist in the scenario?


In the current version of the MaSzyna Simulator, there are two methods of changing the consist in a given scenery or scenario: Go to the site containing two methods of changing trains in the scenarios.
Contents

How to change the weather and season?

Changing the date, season, scenario start time, temperature, visibility and intensity of the rain is available in the Starter.exe application (the default program to run the MaSzyna Simulator). All the options listed below are available in the Scenarios the main window in tab Weather.

In the screenshot below, the options for setting the weather that will be present during the simulation have been marked with a red frame.


Screen 1: Main Starter window with weather configuration

We can change: Any changes made can be restored to the default values by pressing the button Restore default weather.

In the MaSzyna Simulator, the simulation date is set to the same as the system date of the simulation start - if we start MaSzyna on 1st January, winter weather will be simulated (i.e. a lot of snow), if we start on 1st July, summer weather will be simulated.

Important Notice

The date in the scenario, and thus the weather conditions, can be permanently set by the author through an entry movelight in the entry config in the given scenario file.

To change the weather during the simulation, turn on the panel Debug Data (F12), select a panel Scenario, and change the value slider: Fog distance, Cloud cover, Day of year.

To change the time during the simulation, turn on Debug Mode (Ctrl+Shift+F12), then the panel Debug Data (F12), select a panel Scenario, and change the value slider: Time of day.

Important Notice

Changing the time during the simulation will disrupt or completely prevent the correct execution of the scenario!
Contents

How to set the multiplayer up?

Contents

How to set the OpenVR support?

Important note

Please note that OpenVR support in the MaSzyna is in the early phase of implementation.
For using of the VR mode in the MaSzyna, the following are required:
Important note

Currently, controllers support is in the preliminary stage. The elements in the cabin are activated with the indicator by selecting two available actions.
For the Index Knuckles controllers a mapping is included for the buttons A/B.
For other controllers, bind the actions (PrimaryAction and SecondaryAction) in the SteamVR menu.
Additional support the rest of the simulator functionality with the controllers will be added in the future.
You can read more about the OpenVR system in the MaSzyna Simulator and its feature updates at the forum [Polish Only] in a thread.
Contents

Remarks

Why is ... not included in this pack?

In order to understand why the packs don't contain all the add-ons published from the start of the existance of the Simulator, you need to know that for a couple of years, when it comes to add-on creation, there was simply only chaos. Add-ons often ware not tested before being published (there ware no standards, norms etc), which ment that they had errors, ware incomplete and often, ware incompatible with each other (often adding one scenery, broke all the remaining sceneries). Additionally, addons ware often hosted on external servers, which removed them after some time, which caused the forum to be full of dead links, instead of addons. Only at the end of 2008, thanks to Ra, it was possible to clean up the mess, through gathering everything in "Katalog dodatków" / Addon Catalogue , on the eu07.pl server. But to simply have all the addons in one place wasn't enough. The addon publication process was reorganised (from the end of 2008, every single addon, prior to publication, must be subject to mandatory tests). However, the incomplatability problem remained, since there was a lack of official and up-to-date package, which could create some sort of an reference point for the testers and creators (last, unofficial package was published half-way through 2006, however the last official, in 2004). That is why, at the beginning of 2009, a group was created, who spend a couple of months choosing, from previously published addons, the addons that ware worthy and didn't have too many mistakes, and then worked on the inter-compatability of these addons, by removing significant mistakes, filling in the missing files, etc. That is how Paczka Całościowa 2009, 2010, 2011 along with the Service Packs, MaSzyna 01.13, MaSzyna 08.13 and MaSzyna 15.04 ware created. The newest Package is a continuation of that work, and just like the previous Packs, does not contain any low quality addons, or ones in Beta testing. From the beginning of 2018, the publication method of the Pack was changed to a rolling release model, which means that newer versions, will not have release numbers.

Contents

Simulator's executable file – The EXE

In order to find out about all the latest changes, read the changelog at: [Polish Only] EXE C++ upgrade

Contents

What next? When is a new version / new add-ons comming out?

Authors of the "MaSzyna" Simulator are creating this project as a part of their hobby, and pro-bono, sharing the time between family duties, work and the Simulator. That's why, when asked When is the new version/new add-ons coming out? we cannot give a clear answer. Information of the current work and future versions, will be presented on our Facebook, and the project's website. We can also reply to them by E-Mail, contact is given in the Official addresses and contact.

Simultaneusly, we need to add that the group of creators is not a closed group. Every willing and interested person can help in developing the project. There are so many fields, on which one can flourish. Contrary to popular opinion, to create this kind of a computer software, you don't need to be a computer science graduate.

For example, you simply need to have a digital camera to support the modellers with pictures of many different objects, which could me added to the sceneries. Those who don't have a camera, can record sounds of different equipment. In the project's lifetime, some people have been known to learn computer coding or using graphical modelling tools, and as such, to contribute significantly to the project's development.

We highly encourage you to register on the project's forum. It contains tips on creating models, textures, sceneries and many more. In case of problems, experienced users will help, sharing their knowledge and remarks. You can also become a Betatester, who's job it is to test and find mistakes in the new add-ons, support the creators with their help, and to create themselves.

All in all, we recomment you register on our forum, where you will find more information and tutorials. List of queries regarding helping in the development of the Simulator is in this forum thread [POLISH only].

Contents

The Simulator Licence

See the page containing the Licence
Contents

FAQ – Frequently Asked Questions and their answers. Most occuring problems and their solutions

Questions List

In order to get to the answer, please press on the question.
Contents

Answers:


Official addesses and contact

Web sites

Below is a list of official websites, managed by the "MaSzyna" Simulator Team:

E-Mail adresses