Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

November update #229

Merged
merged 6 commits into from
Dec 2, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions dictionary/en-custom.txt
Original file line number Diff line number Diff line change
Expand Up @@ -127,6 +127,7 @@ cSpline
ctrl
CTRL
CuriousMike
AnotherFoxGuy
da
DAF
dampingrate
Expand All @@ -146,6 +147,7 @@ Detacher
difflock
diffusespecular
DirectX
OpenGL
disabledefaultsounds
distro
dll
Expand Down
3 changes: 3 additions & 0 deletions source/gameplay/beginners-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,9 @@ Now you're ready to begin playing. Start by clicking `Single player` to open the

For the sake of this tutorial, select *North St Helens*.

!!! note
Depending on how you downloaded the game, the North St Helens terrain may be missing. If so, please install it from the [Repository](installing-content.md) before continuing.

Once the terrain loads, you will spawn as a country person known lovingly as RoRBot. You control him with the arrow keys while using `SHIFT` to run and `SPACE` to jump (good for getting over bumps, or if you get stuck).

![rorbot](../images/bg-rorbot.png)
Expand Down
42 changes: 22 additions & 20 deletions source/gameplay/common-issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,9 +15,15 @@ When attempting to launch RoR or change game settings, you may receive one of th

### Causes

#### Controlled folder access

On Windows 10/11, Windows Security (Defender) has a "Controlled folder access" feature. When enabled, it blocks applications such as RoR from accessing your Documents folder.

See this tutorial ([Windows 10](https://www.tenforums.com/tutorials/113380-how-enable-disable-controlled-folder-access-windows-10-a.html)/[Windows 11](https://www.elevenforum.com/t/enable-or-disable-controlled-folder-access-for-microsoft-defender-antivirus-in-windows-11.4013/)) for instructions on how to disable it.

#### Unicode characters

The most common cause of these errors is having [Unicode](https://en.wikipedia.org/wiki/Unicode) characters in the path to the `Documents\My Games\Rigs of Rods` folder, typically caused by the Windows (Name of the folder in `C:\Users`, **NOT** the display name!) username (e.g. `André`).
Another common cause of these errors is having [Unicode](https://en.wikipedia.org/wiki/Unicode) characters in the path to the `Documents\My Games\Rigs of Rods` folder, typically caused by the Windows (Name of the folder in `C:\Users`, **NOT** the display name!) username (e.g. `René`).

There are three workarounds to this problem. Fix #2 is recommended if you don't want to run RoR as administrator.

Expand All @@ -40,17 +46,7 @@ Following either method will result in RoR now using the `config` folder instead
If you installed the content packs, you will have to move the `*.zip` files from `Documents\My Games\Rigs of Rods\mods` to `config\mods`. New mods are also installed there.

##### Fix #3
The last solution is simply to create a new Windows user account without any special characters or wipe your drive and install a new copy of Windows.

#### Controlled folder access

Controlled folder access is a feature of Windows Security (Defender). When this feature is enabled, it blocks applications such as RoR from accessing your Documents folder.

Please see [this page](https://www.tenforums.com/tutorials/113380-how-enable-disable-controlled-folder-access-windows-10-a.html) for instructions on how to disable it.

#### OneDrive

OneDrive is known to prevent RoR from accessing the Documents folder. The only solution is to uninstall OneDrive.
The last solution is simply to create a new Windows user account without any special characters or reinstall Windows.

## No render system plugin available

Expand All @@ -60,7 +56,6 @@ OneDrive is known to prevent RoR from accessing the Documents folder. The only s

If you downloaded RoR using the zip file, you may receive these errors. This is caused by the DirectX 9 Runtime not being installed. Install it from [Microsoft's website](https://www.microsoft.com/en-us/download/details.aspx?id=8109) then restart your PC.


## Visual C++ DLLs missing

When launching RoR, you may receive a MSVCP140.dll/MSVCP110.dll/MSVCP100.dll not found error.
Expand Down Expand Up @@ -89,7 +84,7 @@ This error is usually caused by enabling full screen with the wrong resolution (
2. Start RoR, the game will be in a small window. Click Settings -> Render system and change the Video Mode setting to your monitor's **native resolution** (e.g. 1920x1080). Enable full screen if you want.
3. Restart RoR.

If this doesn't fix your error, then your GPU is most likely too old to run RoR.
If this doesn't fix your error, then your GPU is likely too old to run RoR.

## Null program bound

Expand All @@ -99,12 +94,22 @@ This error occurs with some Intel integrated graphics chips. Unfortunately there

More info: [GitHub issue](https://github.com/RigsOfRods/rigs-of-rods/issues/2385)

## Glitchy vehicle shadows
## Low resolution terrain textures

On AMD graphics cards under Linux (OpenGL), terrain textures may appear low resolution:

![low-res-terrain-tex](../images/low-res-terrain-tex.jpg)

This is caused by shadows, you will need to disable them (Settings -> Graphics -> Set shadows to "None" -> Restart RoR).

Alternatively you can play the Windows version through [Wine](https://www.winehq.org/).

## Flickering vehicle shadows

!!! note
This issue does not occur as of version 2022.12+

With some GPUs (mostly integrated ones), shadows on vehicles may appear glitchy:
With some GPUs (mainly integrated), shadows on vehicles may flicker:

![shadows-glitch](../images/shadows-glitch.gif)

Expand All @@ -117,7 +122,7 @@ The simplest workaround is to just disable shadows. (Settings -> Graphics -> Set
### Fix #2: Enable classic materials

!!! note
As of version 2022.12, the "classic materials" are enabled by default with the option removed.
As of version 2022.12, the "classic materials" option isn't available as it is now enabled by default.

In versions 2020.01 to 2022.04, an option to enable classic (0.38-era) material shaders is available. This can be found under Settings -> Graphics -> Classic material shaders.

Expand All @@ -141,9 +146,6 @@ If you prefer to use the default materials instead, do the following:

## Airplane spawning crash

!!! note
Confirmed fixed in 2022.12+. Please note that changing light sources to None will cause no flares (headlights etc) to appear.

If the game crashes when spawning an aircraft, change the Lights setting (Graphics tab) to anything that isn't `None (fastest)`:

![airplane-crash-lights-fix](../images/airplane-crash-lights-fix.png)
13 changes: 8 additions & 5 deletions source/gameplay/general-faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Windows XP & Vista are no longer supported as of version 0.4.8 RC5.

MacOS hasn't been supported since version 0.37 due to lack of developer interest and outdated dependencies currently used by the game.

Any other platform (ChromeOS, and iOS/Android) are unsupported and likely never will be.
ChromeOS and mobile platforms (iOS/Android) are unsupported and likely never will be.

### Windows

Expand Down Expand Up @@ -62,12 +62,14 @@ For more info regarding installing mods, see: [Installing content (mods)](instal

### Archives

The forum archives have been partially [unavailable](https://forum.rigsofrods.org/threads/archives-temporarily-unavailable.2777/) since September 2020.
The forum archives have been [unavailable](https://forum.rigsofrods.org/threads/archives-temporarily-unavailable.2777/) since September 2020.

A backup of the old Repository files may be found [here](https://cdn.anotherfoxguy.com/repo-backup/).
Another backup of a VBulletin forum (prior to the switch to XenForo) may be found [here](http://www.austingratzer.com/rigs/).
A backup of the original Repository files (hosted by [AnotherFoxGuy](https://forum.rigsofrods.org/members/anotherfoxguy.40/)) may be found [here](https://ror-mini-pictures.netlify.app/).

Please note that the archives contain older versions of mods which may not be compatible with the latest RoR version. Always check the current [Repository](https://forum.rigsofrods.org/resources/) for the latest versions.
!!! warning
The Repository archive contains a handful of content featuring Sketchup 3D Warehouse assets that were released prior to the rule prohibiting the use of these models. These are considered stolen content (see below) and are not allowed on official services.

It also contains older versions of mods which may not be compatible with the latest RoR version. Always check the current [Repository](https://forum.rigsofrods.org/resources/) for the latest versions.

### Downloading mods from unofficial sources

Expand All @@ -76,6 +78,7 @@ They are not allowed on any of our services, including multiplayer. May also con

Further reading:<br>
[Don’t Steal Content or Violate Intellectual Property](../rules/community-guidelines.md#dont-steal-content-or-violate-intellectual-property)
<br>
[Stolen Content (Bus Epidemic)](https://forum.rigsofrods.org/threads/stolen-content-bus-epidemic.2034/)

## Multiplayer
Expand Down
Binary file added source/images/low-res-terrain-tex.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added source/images/twin-traction-beam.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion source/terrain-creation/object-format.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ end

The format is described below:

The first line specifies the visual mesh to use
The first line specifies the visual mesh to use. Can be set to `none` to disable visuals, useful for event boxes.

The second line specifies the scale of it (`x`, `y`, `z`)
Default: `1,1,1`
Expand Down
2 changes: 0 additions & 2 deletions source/terrain-creation/scripting.md
Original file line number Diff line number Diff line change
Expand Up @@ -812,5 +812,3 @@ string arrayToString(array<string>@ arr) {
### Troubleshooting

If your race doesn't work, feel free to post your terrain file in this forum, and we may have a look at it. <https://forum.rigsofrods.org/forums/content-support.10/>

Further, you may find some help in this archive: <http://rigsofrods.org/old-forum/forums/167-Scripting/page-0001.html>
2 changes: 1 addition & 1 deletion source/terrain-creation/shadows.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ As soon as you put all these three, you will get working shadows with a detailed

### Vehicles

Shadows no longer cast onto vehicles as of version 2022.12+ due to [graphical glitches](../gameplay/common-issues.md#glitchy-vehicle-shadows).
Shadows no longer cast onto vehicles as of version 2022.12+ due to [graphical glitches](../gameplay/common-issues.md#flickering-vehicle-shadows).

### Misc
Other than the `RoR/Managed_Mats/Base` inheritance, you can use all these for each type of texture/model used.
Expand Down
2 changes: 1 addition & 1 deletion source/tools-tutorials/addons.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Installing Addons (Manual)

## What are addons?

In the [Repository](https://forum.rigsofrods.org/resources/) and [Archives](http://archives.rigsofrods.net/), you will find a category for [addon parts](https://forum.rigsofrods.org/resources/categories/addons.15/). These are ready-to-install modifications for existing vehicles.
In the [Repository](https://forum.rigsofrods.org/resources/), you will find a category for [addon parts](https://forum.rigsofrods.org/resources/categories/addons.15/). These are ready-to-install modifications for existing vehicles.

Some are designed for specific vehicles (e.g. bumpers/exhausts) while others can fit on any vehicle (e.g. wheels/tires). This page serves as a general guide on the basics of installing various types of parts.

Expand Down
8 changes: 2 additions & 6 deletions source/tools-tutorials/blender-mesh-editing.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,13 +27,9 @@ We'll also assume you are running Windows, however these instructions should mos

## Blender version warning

On July 2019, Blender 2.8 was released. It was the biggest release in Blender's history, reworking a lot of Blender's core features.
This included changes to the addon API, which means addons need to be updated to support the newer versions.
This page was written for Blender 2.79 and has not yet been updated for newer versions. For 2.8+ you can use the [blender2ogre plugin](https://github.com/OGRECave/blender2ogre) to import/export meshes.

As of November 2022, the [Ogre Mesh Import/Export plugin](https://github.com/OGRECave/blender2ogre) _technically_ _supports_ Blender 2.8+,
it currently suffers from usability bugs that prevent this page from being updated.

For this reason we recommend using Blender 2.79 to edit meshes.
When downloading Blender from the above link, avoid the versions in the `latest` folder! They do not support the addons. If you're unsure, download `blender-2.79-windows64.msi`.

## Getting started

Expand Down
2 changes: 0 additions & 2 deletions source/vehicle-creation/motorbikes.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,6 @@ Motorbikes

This tutorial covers the theory and concepts used to build real 2-wheeled vehicles in Rigs of Rods.

Based off [this archived forum thread](http://archives.rigsofrods.net/old-forum/forums/120-Mod-tech/95634/page-0001.html).

## Theory

Motorbikes are counter-intuitive, to turn left, you must steer right a little first and vice-versa. It is because of this that the player cannot control the steering directly (with hydros) because the response time is too long and there is no feedback like when you ride a bicycle. So you must use [animators](fileformat-truck.md#animators) and the `roll` option. This is what we use to turn the front wheel.
Expand Down
3 changes: 2 additions & 1 deletion source/vehicle-creation/suspension.md
Original file line number Diff line number Diff line change
Expand Up @@ -205,7 +205,8 @@ Example using torsion bar suspension front and rear. You will notice the wheels

### Other forms of independent suspension

- **Twin Traction Beam** - A beam that goes to the other side of the truck where it is connected to the chassis. [Example](http://www.explorer4x4.com/zimmods97.jpg).
- **Twin Traction Beam** - A beam that goes to the other side of the truck where it is connected to the chassis.
![twin-traction-beam](../images/twin-traction-beam.jpg)
- **Multilink** - Multilink, or 5-link, system are called so because they use 5 different points to connect the fusee to the chassis.
- **Trailing-arm** - Two arms that look like the 4 link system except that there is not solid axle.

Expand Down