MaSzyna - Railway Vehicle Simulator EP07-424

MaSzyna 15.04

The Readme File

AUTHOR: libertyn89

UPDATE: Maciej

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

Contents

Introduction

The beginning of MaSzyna dates back to the year 2001. It was mainly a graphic engine test. The simulator got it's current shape in 2003. Since then, it's continously developed. Thanks to many people's work, many different railway vehicle models have been created, as well as many scenarios, textures and sounds. It has to be noted that everything here was created in spare time, as a hobby. For this reason, not everything is created in a professional manner, like in the commercial products. If you have time and want to help us, then join us!

I've downloaded the simulator, now what?

Installation?

No. You do not install MaSzyna. After downloading the MaSzyna 15.04 package, it needs to be extracted to a new folder. Do not extract the package to an existing folder with MaSzyna, since 15.04 is NOT a mod or an update for any existing packages like PC 08.13 or any other older versions of MaSzyna. To extract, we recommend the free software "7-Zip" version 9.20 (to download from http://7-zip.org), since using WinRAR might cause problems.

First run

To launch MaSzyna, use Rainsted launcher, created by Ra. It functions as starter and a train consist editor (but also a realistic scenery editor, more on it further down and more information is on rainsted.com [POLISH ONLY] Enter the main MaSzyna folder. Launch Rainsted.exe (icon like in screen 1 below).

Screen 1: Rainsted launcher icon

You should see the following window (screen 2):

Screen 2: Rainsted (launcher)

Durning first run, Rainsted launcher processes and generates certain configuration files. It can take upto around a minute. It is a one-time process - every other launch of Rainsted will launch much quicker.
Rainsted was succesfully started when the following window appears (screen 3):

Screen 3: Rainsted, Choose Scenery tab

The titlebar says: "Wybierz scenerię :: MaSzyna EU07-424 :: Rainsted 15.1.108.10181". The "15.1.108.10181", is not Simulator version number, but the version of the Rainsted Launcher and changes when Rainsted is updated.
Go to Settings (or Ustawienia if the Launcher started in the Polish language) and in the Select language (or Wybór Języka) and choose your preferred language.
From here on, we assume that the language was set to English.
Settings tab (screen 4) allows for configuring such parameters, like screen resolution.

Screen 4: Rainsted, Settings tab (in Polish)

The important setting in the Settings tab, is the User mode. It can be changed, depending on the knowledge of the user. This setting affects Rainsted ONLY and has no effect on the simulation whatsoever. Let's look at options from the "Settings in EU07.INI" pane. These DO affect the simulation.

The remaining options should be left as they ware.

In the Choose scenery tab, is a list of all the available scenarios. As you can see, we have tens of different scenarios. In the beginning we will choose the simplest route to become aquainted with the Simulator. Choose the TD scenario, in the Select trainset to drive pane, click on EP07-424+BD+BDHPUMN+BDHPUMN and press Run Simulator.

Important Notice
After choosing any scenarios and the trainsets, familiarise yourelf with the information in the middle field of the Select scenery and the right field from the Select trainset (for example scenario calkowo_orlen.scn; screen 5), and also with any possible descriptions, available after pressing the buttons (in the middle field of the Select scenery pane, or in the "inne/[scenario name]" (not all routes have it [for example TD doesn't have one]).

Screen 5: Rainsted, Scenario description

A window will appear (screen 6):

Screen 6: Rainsted, Starting Information

Familiarise yourself with the starting information (It is shown only for a couple of the most used vehicles; full description of keys and controlling the trains will be further down in this read me file). Next, press Run simulator.

Time for the most important stage
After a moment (no more than a minute) the startup window should appear (screen 7).

Screen 7: Symulator MaSzyna - startup screen window

It may vary from the one on the screen, since the Launcher chooses one at random before displaying it. In certain cases the "Uruchamianie / Initializing" text may not be visible, however, it does not influence the simulation in any way and should be ignored.

After few seconds, the logo may (but doesn't have to) turn into a white background, or fade slightly (Windows Vista and 7). In this moment most user panic, thinking the Simulator froze. That is not the case. It is still loading all the necessary files (eventhough, the Task Manager [and the Simulator's Titlebar, screen 8 and 9]may show it to be "Not responding").

Screen 8: MaSzyna Simulator- Startup screen, Windows XP and olderScreen 9: MaSzyna Simulator - Startup screen, Windows Vista & 7

To find out about that, all you have to do is press Alt + Tab. Then we will see the "Terminal" (on Windows Vista and 7, switching to the terminal durning loading only works if the Fullscreen mode is unchecked; and then, once the simulator has loaded, the Alt + Tab combination works normally, even in fullscreen mode). We will be able to watch the simulator loading process. Sometimes, it can stop for a while on the stage shown on the screen 10 (Sound Init… OK) , however, it won't stay there forever :)

Screen 10: MaSzyna Simulator - loading of the sim in the terminal

You just need to wait untill it finishes loading.

The scenario has loaded when the following is displayed in the terminal:
Player train init OK

We should be automatically moved to the cab. If not, we switch into the window with the simulation, by using Alt + Tab.

After the cab has loaded, we begin the simulation in the standing position, as if we just entered the cab through the doors. To sit down at the controls, press the Right Mouse Button.

If durning loading ( or after, durning the simulation) a notification is displayed, that the program has carried out a incorrect operation, that it has stopped responding / froze or that there was a fault with the application, it means that, most probably you have very old drivers for your graphics card (In these cases, it is very common that in the first few lines of log.txt the following test is displayed: "OpenGL Version: 1.1.0"). In that case, in order to run the Simulator, download (for example from the graphic card's manufacturer's website) and install newer drivers (in some cases it may be necessary to uninstall previously installed (the older) drivers ; in some cases, "DriverCleaner" app may be of use ).

Keyboard Control

Important notice

The keys and their functions have been slightly altered (in regards to previous Simulator versions). We reqest that you familiarise yourself thoroughly with the description available below.
Go to the site containing Keyboard Contols

Control

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

Important notice

The start-up procedure had been altered (in relation to previous versions of the Simulator) and we reqest that you familiarise yourself thoroughly with the description available below.
Go to site containing Train Control description.

Changing Cabs

In order to move to the other cab, press either:

Attention: In between the cabs, there 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) unit, to unit s (Motor Coach), and then End three times, in order to move to rb 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).

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).
WARNING: If your train is to be coupled up to a train driven by AI, (ie. you drive a Banking Engine or the AI hauls our loco/train ), then it is absolutely necessary to set the Train Brake to the Cut-Off position (Ctrl + Num 5)!
If the user drives 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.

How to change the consist in the scenario?

Important Notice

Please pay attention to how to place EMUs in the scenarios (including, amongst others; the EN57). Not paying special attention with the information below is the leading cause of having trouble with starting up the EMUs.
Go to site containing two methods of changing trains in the scenarios.

How to change weather, sky?

With the help of Rainsted.exe Launcher, which allows us to change the sky, along with setting the specially tailored atmo and light parameters. In order to do this , after starting the Launcher, we will need to:

Turning on and off the platform lamps

Contents of the Pack

Sceneries (Routes) and scenarios

NameAuthors, notes
BałtykAuthors: adampkp, Slimson, Mateu. Route finish (scenarios, fixes): Krzysiek626, Mati_An.
Bałtyk CargoScenario for Bałtyk scenery. Author: kamil1306.
Bałtyk CTLScenario for Bałtyk scenery. Author: kamil1306.
Bałtyk InterregioScenario for Bałtyk scenery. Author: szogun.
Bałtyk_zimaBałtyk scenery (Winter) mod. Author: Sigman.
CałkowoAuthors: adampkp, Slimson. Semaphore lighting: Benek. Decorations: Trus
Całkowo_OrlenScenario for Całkowo scenery. Author: Benek.
Całkowo_SN61Scenario for Całkowo scenery. Author: SKP.
Całkowo OdysejaDecorations: Trankei, Stele Scripting: Transkei
Drawinowo 2Author: Mati_An.
Elektrociepłownia_dobreAuthors: sm42driver, szogun.
Elektrociepłownia_dobre-zimaAuthors: sm42driver, szogun, macius5991.
Krzyżowa 2Author: Mati_An.
Linia 053Author (Route and scenarios 1-6): Driver24. Decorations: Trus
Scenario "Linia 053 - Express and Freight mission" (l053-sluzba-brutto-posp): Mati_An.
Scenario "Linia 053 - Night Shift - 4_v2" (l053-sluzba-4-night_v2) Author: Benek.
Scenario "l053-sluzba-osobowy" (Suburban) Author: Benek.
Scenario "l053_cargo" Author: pinokio.
Scenario "l053-night-towarowy-et22" (Freight) Author: Woku.
Scenario "l053-night-towarowy-et42" (Freight) Author: Woku.
Scenario "l053-night-towarowy-eu07" (Freight) Author: Woku.
Linia 053 + CałkowoAuthors: Driver24 & Mati_An.
Scenario "Linia 053 + Całkowo TLK" Author: Mati_An.
Scenario "Linia 053 + Całkowo TLK-1" Author: Mati_An.
Linia 61Authors: BohunIC, ISDR. Fixes: adsim. Rebuilding: Ra
Scenario author "linia61_osobowy3": dymus.
Radio for "towarowy1" scenario : pinokio.
Scenario author "linia61_tlk-1": Benek.
Linia61 + Linia144Scenario author: ISDR. "Ozimek - Fosowskie" section: BohunIC. Decorations: Trus
Scenario "L61 + L144_towarowy" Author: ISDR.
Author of "L61 + L144_osobowy" and "L61 + L144_pospieszny" scenarios: Benek.
Scenario "L61 + L144 Lotos" Author: Woku.
Scenario "L61 + L144 TLK" Author: Benek.
Manewrowo 3Author: pozdze.
MocznikiAuthor: wasyl.
Moczniki CargoScenario for Moczniki scenery. Author: Benek.
Moczniki PopychScenario for Moczniki scenery. Author: Benek.
Quarkmce 2007Authors: Quark-t (terrain and track layout), McZapkie (considerable expansion), Mati_An (scenarios), Krzysiek626 (electrification, superelevations), Ra (new traffic control, scenario remodelling).
TarniowoAuthor: Mati_An.
Tarniowo 2Authors: Mati_An (original), Ra (rebuild).
TDAuthor: Marcin E2rD.
Teszt-25kVTD scenery modification. Hungarian signs ware added, and the catenary is 25kV AC. Author: Ra.
WARNING! Electric locos can not be driven on this scenery since the Polish vehicles are designed for 3kV DC and not 25kV AC power supply.
ZwierzyniecAuthor: wasyl; Radio for freight and express scenarios: filip2h.
Zwierzyniec ED72Scenario for Zwierzyniec scenery. Author: Woku.
Zwierzyniec SM42Scenario for Zwierzyniec scenery. Author: Woku.
Zwierzyniec TLKScenario for Zwierzyniec scenery. Author: szogun.
Zwierzyniec TowosScenario for Zwierzyniec scenery. Author: Benek.
Zwierzyniec TransportScenario for Zwierzyniec scenery (swapping textures for winter ones - szogun). Author: Woku.

Vehicles

Package information

MaSzyna 15.04 is based on previous versions (08.13, 01.13, PC2011, 2010, 2009). This version has largely focused on fixing the layout of the catenary on the sceneries, in order to fully utilise the new feature of simulating the contact between the pantograph and the catenary, and improving the catenary power supply chain.
Teams that prepared these packs:

Many other people also contributed, but we have no way of listing every single one ot them. We thank everybody that helped.

Improvements and new EXE functions

New Stuff

Important notice
When the cab has loaded, we begin the simulation in the standing position, as if we just entered the cab through the doors. To sit down in front of the controls, press right mouse button.

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 and MaSzyna 08.13 ware created. Newest Package (called MaSzyna 15.04) is a continuation of that work, and just like the previous Packs, does not contain any low quality addons, or ones in Beta testing.

The Simlator's executable file – EXE

MaSzyna 15.04 contains "EXE 469" (eu07.exe file, the 15.3.1166.469 version, 1263 kiB in size, located in the main folder of the Simulator) created by Ra and youBy. It eliminates many mistakes, and contains some new functions. In order to see the full changelog of EXE 469 (in respect to the EXE from MaSzyna 08.13 pack), read the (Polish only) descriptions on the website dedicated to: [ALL THE FOLLOWING LINKS ARE IN POLISH ONLY]: EU07.EXE 414, EU07.EXE 424, EU07.EXE 435, EU07.EXE 441, EU07.EXE 450, EU07.EXE 457, EU07.EXE 464 and EU07.EXE 469.

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

We are hobbists, who have to divide our time between families, jobs, learning and only in our spare time we can create things for the Simulator. That is why, when asked "When is the new loco/route/pack comming out?" we can not give a 100% accurate (or binding) answer. We are not a group closed to new people and their ideas. If you want to conribute, we will welcome you :) You can, for example, help the add-on creators by photographing the infrastructure, buildings etc. in order to make the routes in MaSzyna more realistic. More info here: [POLISH ONLY] http://eu07.pl/forum/index.php/topic,17369.0.html.

If you are good at programming, modelling, sound editing, you have a good camera or simply have loads of spare time, then we would be happy to work with you on improving the Simulator.

The Simulator Licence

See the page containing the Licence

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.

Answers: