Greetings. This readme file will give you an overview of what the mod offers and how to install it.

Please read the whole file before installing this mod.


Purpose of this mod:
--------------------

This mod aims to make the worldmodel weapons playable, since the viewmodels often differ a lot from them.
A good example is the double barreled shotgun.
It appears small in first person, but its world model has long barrels and a darker texture.
The mod also gives the standard shotgun a world model, which can be seen in Arcane Dimensions.

Content:
--------

This mod comes mainly in two versions.
'Standard' and 'With Hands'.

Standard - Contains simply the weapon models. No hands. Optimised for a more traditional, centered weapon experience.
With Hands - The weapons are now held with hands. This package is best enjoyed with source ports which allow the angling of weapons.

Additional Packages:

- Quake Test Nailguns - Makes the nailguns from QTEST playable.
- Arcane Dimensions - Makes the worldmodels of Arcane Dimensions playable.
Best used with Arcane Dimensions, but can also work with the standard game.
- ShotgunVanillaPosition (for Arcane Dimensions) - Raises the position of the single shotgun to look more like in the standard game.


Installation:
-------------

1. Choose the version you want.
2. Open the root folder of your Quake installation.
File path if purchased from Steam:
?:\Steam\steamapps\common\Quake - Standard
?:\Steam\steamapps\common\Quake\rerelease - Quake Remaster
3. Navigate to your 'id1' folder and drop the pak file of this mod's id1 folder inside it.
4. Do the same for the hipnotic (SoA) and rogue (DoE) folders.
5. Play the game.

Inside this ZIP is a picture which will help you.

Installation of the additional packages:

Do the same for them. The folder structure will guide you.

Troubleshooting:

But what if you already have pak files with a matching number inside?
Simply rename this mod's pak file to a higher number. E.g. from pak1 to pak2.
Do not skip numbers when renaming, the game will ignore non neighboring numbers.
You could also delete the conflicting pak file if you know that it's from a mod.

But you just did that and the mod does not work?
If you are using the remaster, the mentioned file destinations above are in the 'rerelease' folder.
Also, disable the improved weapon models in the video options.

If you aren't playing with the remaster, check if the source port supports the mod.
Consult its console or log file for more info.


How to angle weapons:
---------------------

Quake Remaster:

Open the console and type in these commands:

scr_ofsx # - Moves weapons further or closer to the screen. Negative values move them further away.
scr_ofsy # - Moves weapons to the right or left. Negative values move them to the right.

The value '0' is the default for both commands.

I recommend a value of -6 for both for a good experience.
The command gets disabled when playing multiplayer, even with bots.

Quakespasm has viewmodels angled by default.

For other source ports you must consult their official documentation.


Compatibility:
--------------

This mod works with the following sourceports:

Quake Remaster - Nightdive Studios
DarkPlaces - Ashley "LadyHavoc" Hale
Quakespasm - Ozkan, Eric, Sander & Stevenauus

This mod does NOT work with:

WinQuake - Crashes the game upon loading the demo.
GLQuake - Crashes the game upon loading the demo.

Source ports which have not been listed here, were simply not tested.

'Worldmodel to Viewmodel' was mainly made for the remaster.


Modders info & Permissions:
---------------------------

This mod was made with qME 3.1, paint.net and QuArK 6.6 (Quake Army Knife).

You can upload this mod to other sites.
If you do so, you must credit me, because false information creates trouble for everyone involved.

You can modify this mod and use parts of it in your own mod, as long as you give credits to their original author(s).

You are NOT allowed to use any parts of this mod in any files which are being sold.

Internal workings of this mod are not fine tuned, as this mod was intended for my own usage at first.
If you are going to modify these files, you will understand what I meant by that.


Credits:
--------

Standard models: id Software, Rogue Entertainment and Hipnotic Software
Quake TEST nailguns: id Software
Arcane Dimensions: g_nail.mdl, g_rock.mdl & g_rock2.mdl by SimonOC
g_shot2.mdl, g_nail2.mdl & g_light.mdl by Stas "dwere" Kuznetsov
g_shot3.mdl, g_plasma.mdl by slapmap.wordpress.com, direct link: https://slapmap.wordpress.com/category/releasedownload/


This mod was developed by Schrotflinte12.