======================================================================
Restricted City Entrance - v 1.1
by DuggeDank
Released: 2008-04-12
======================================================================

Version 1.1 released

I have not been able to test the No SI version as I have Shivering Isles installed myself, but I think it should work.

Please report anything odd here or on the BGSForums so I can correct it.

Updates to this mod may consist of things like making parts of the IC restricted as well and creating compatibility versions for the more popular city mods out there.
Stay tuned...


======================================================================

Contents
--------

1. What is it and what does it do?
2. Installation, Uninstallation and Updating
3. Detailed Information and Configuration
4. Requirements
5. Known issues and Compatibility
6. Credits
7. Legal
8. Version History

======================================================================


What is it?
-----------

Do you think that it's strange how the town guard doesn't seem to care that you are an infamous murderer?
Do you think that somehow the guards should want to keep murderers out of their town?

Then this mod is something for you.



What does it do?
----------------

Restricted City Entrance is a mod that keeps a tab of your infamy, fame and maximum bounty and uses that
to stop you from entering cities when you become to infamous. At every town and castle gate you will find
a Gate Guard that makes sure anyone wanting to pass is not a recognised criminal.
If you end up having a higher reputation for crime than the city allows, you are expelled until you are able
to change the publics opinion of you (gain more Fame).
On top of this "permanent" ban there are "temporary" bans. These are applied anytime you are caught with a
bounty on your head, no matter if you choose to pay your fine or to serve your time you will be banned for
an amount of days corresponding to your bounty.
Different towns have different acceptance to infamy and crime, Bravil for example is more lenient on criminals
than any other town in Cyrodiil.
The Imperial City is unrestricted because of it's great size and difficulties in controlling
the massive amount of people travelling through, to and from the Capital.

One more or less big change that I introduce is the moving of the prison markers to outside the city gates.
Which means that when you pay a fine or serve your time you will end up outside the city, not just outside the castle.

======================================================================


How do I install it?
--------------------

1. Download the packed .esp and sound folder

2. Unpack the archive into your Oblivion\Data folder, overwrite if asked to.
If you do not have he Shiverign Isles expansion you should use the .esp in the "No SI" folder.
- Alternately create an omod file with the help of OBMM.
You should have these folders and files in your Oblivion\Data directory:
\DD_RestrictedCityEntrance
\Sound\Voice\DD_RestrictedCityEntrance.esp\Imperial\m\ "The sound and lip files"

3. Enable the mod through your choice of launcher and play the game!


How do I uninstall it?
----------------------

1. Disable the mod in your launcher.

2. Start Oblivion and load your game (ignore any "missing content" warnings),
save your game again to remove all traces of the mod.

3. Delete the file "DD_ProxSneakPenalty.esp" in the data folder.


How do I update from an older version?
--------------------------------------

1. Uninstall the mod according to the uninstall instructions. Remember to save your game to create a "clean" save.
Also remember to write down any changes you have made to the settings before uninstalling.
If you do not remember what you changed them to, you can open the console and check what their values are
with these commands:
sqv DDREMainQ
sqv DDREBanQ

2. Install the new version according to the install instructions.


======================================================================


What are the details?
---------------------

There are two ways to be expelled from a town:
1. Too high infamy compared to fame, too high Maximum Bounty and being the "wrong" race.
2. Being arrested with a high enough bounty.

A ban resulting from alternative 1 is permanent until you can either lower your infamy or
increase your fame to balance it out.

A ban resulting from alternative 2 is temporary and depends on the bounty you were arrested for.


More information on how these two ban system works can be found in the included spreadsheet.

Mechanics of Infamy/Fame:
The mod uses Fame, Infamy, Maximum Bounty and your Race as a measurement on how welcome you are in a town.
These are added together to give you an "entrance value" that is compared to the "entrance limit" of the town
or castle in question. If your value is lower than the limit you will not be allowed inside the town and
if you find a way inside anyway you will be arrested on sight.

This is the formula used:

Entrance value = Infamy - Fame/1.5 + BountyPen + RaceMod

BountyPen is 10 if your maximum bounty has exceeded 5000 but 0 if it hasn't.
When someone reaches such a high bounty they are recorded as a notorious criminal in all town guard logs.
RaceMod is -5 or +5 depending on the town or castle you are trying to enter.
Bruma is more frienly towards Nords, if you are a Nord it will be slightly easier for you to enter Bruma.
Cheydinhal is more friendly towards Dark Elves.
Leyawiin Castle does not like Argonians, Khajiit and Dark Elves. The Countess has made sure the guards are
stricter towards these races.

The default entrance limits for the cities are:

Anvil=35
Bravil=45
Bruma=40
Cheydinhal=35
Chorrol=25
Leyawiin=35
Skingrad=25

AnvilCastle=15
BravilCastle=15
BrumaCastle=15
Cheyd.Castle=15
ChorrolCastle=10
LeyawiinCastle=15
SkingradCastle=10


So as you can see if you gain a maximum bounty of 5000 you are suddenly on the verge of not being allowed in Chorrol
or Skingrad castle, just one single point of infamy will stop you from entering.
Unless you have a high Fame, in which case it can cancel the Infamy and BountyPen and allow you to enter.

I like to think about it as a general reputation system.
Infamy and Maximum Bounty over 5000 have a negative effect on your reputation and the town guard will
recognise you as a criminal.
Fame will have a positive effect on your reputation, but Infamy is stronger than Fame, once people have formed
a bad opinion of you it is hard to wash it off and you will have to prove yourself to everyone.
The effect of your Race depends on the opinions of the townsfolk and/or it's leaders. Bruma and Cheydinhal have
a major population of Nords and Dark Elves respectively which is why a player of these races are more accepted.
Leyawiin Castle on the other hand with the racist Countess at the helm is not as friendly towards Argonians,
Khajiit and Dark Elves. The Countess has made sure that the castle guards are less trusting of these races.
There's no effect when you try to enter the city itself though, there are several Argonians and Khajiit living there
as it is and as the town guards have a close relation to the citizens they do not all share the countess views.


Mechanics of Bounty:
Here I'm using the bounty that you have when you are arrested and choose to pay your fine/serve your sentence.
If it exceeds the towns acceptance of "misdemeanour" you will be temporarily banned for a time corresponding to the bounty.

The default misdemeanour limits for the cities are:

Anvil3 * iCrimeGoldAttack-->120 with vanilla settings (3 * 40)
Bravil4 * iCrimeGoldAttack-->160 with vanilla settings (4 * 40)
Bruma3 * iCrimeGoldAttack
Cheydinhal3 * iCrimeGoldAttack
Chorrol2 * iCrimeGoldAttack-->80 with vanilla settings (2 * 40)
Leyawiin3 * iCrimeGoldAttack
Skingrad2 * iCrimeGoldAttack

iCrimeGoldAttack is the bounty for an Assault (this is not compatible with RGO's way of setting crime bounty).
So most of the time you won't be banned for a simple bar brawl...

How long you are banned also depends on the misdemeanour limit:

1 x Limit = 1 Day
2 x Limit = 2 Days
and so on...

So in Chorrol you are banned for one day if arrested with a bounty of 80-159, two days if it's 160-239...
And in Bravil you are banned for one day if arrested with a bounty of 160-319, two days if it's 320-479...


How and when is the entrance decided?
When you click on one of the city or castle gates an "entrance number" is calculated and compared to the entrance limit
of the town/castle in question, if your entrance number is lower than the entrance limit you are free to pass.
If it is higher, if you currently have a bounty on your head or if you have a temporary ban - a guard posted at the gate
will initiate dialogue with you.
If you have a bounty he will use the "arrest" greeting and you get the normal choices.
If it's a temporary ban he will explain why you are not allowed into the city and how long you have left on the ban,
or in the case of a permanent ban he just tells you to find some other town to terrorize.

When you are temporarily banned from a city, you have the option of bribing the gate guard, but this is a risky business
as it is illegal to accept bribes and sometimes guards actually enforce that...
You can not bribe your way through a permanent ban.


If you are banned in any way from a town and manage to get inside in a more obscure way than through the main gate,
the mod will detect this and start checking for guards in your vicinity, if a guard is close enough and spots you he
will immediately run up and arrest you. The bounty for breaking a ban is the same as the towns misdemeanour limit,
which effectively increases your temporary ban by one day.
All castles are harsher than cities when it comes to breaking bans, you get a higher bounty and your temporary ban
may be prolonged with more than a day.



Is it configurable?
-------------------

You can change the settings from the console with these commands:
(Open the console with the ~key)


Restricted Castles
There are currently not many mods that add secret entrances to castles as well as cities,
so some people may not want the castles to be restricted.
If you don't want castles to be restricted you can turn this off:

set DDREMainQ.RestrictedCastles to 0

To turn it back on:

set DDREMainQ.RestrictedCastles to 1

Castles are restricted by default (Default: 1)


City and Castle Entrance Limits
X is the Entrance Limit of the city or castle, a player Entrance Value above this blocks entrance.

set DDREMainQ.anvilCity to X(Anvil Default: 35)
set DDREMainQ.bravilCity to X(Bravil Default: 45)
set DDREMainQ.brumaCity to X(Bruma Default: 40)
set DDREMainQ.cheydinhalCity to X(Cheydinhal Default: 35)
set DDREMainQ.chorrolCity to X(Chorrol Default: 25)
set DDREMainQ.leyawiinCity to X(Leyawiin Default: 35)
set DDREMainQ.skingradCity to X(Skingrad Default: 35)

set DDREMainQ.anvilCastle to X(Anvil Castle Default: 35)
set DDREMainQ.bravilCastle to X(Bravil Castle Default: 35)
set DDREMainQ.brumaCastle to X(Bruma Castle Default: 35)
set DDREMainQ.cheydinhalCastle to X(Cheydinhal Castle Default: 35)
set DDREMainQ.chorrolCastle to X(Chorrol Castle Default: 35)
set DDREMainQ.leyawiinCastle to X(Leyawiin Castle Default: 35)
set DDREMainQ.skingradCastle to X(Skingrad Castle Default: 35)

Temporary bans
X is the number that the assault penalty is multiplied with to get the Misdemeanour Limit.

set DDREBanQ.anvBanMod to X(Anvil Default: 3)
set DDREBanQ.braBanMod to X(Bravil Default: 4)
set DDREBanQ.bruBanMod to X(Bruma Default: 3)
set DDREBanQ.cheBanMod to X(Cheydinhal Default: 3)
set DDREBanQ.choBanMod to X(Chorrol Default: 2)
set DDREBanQ.leyBanMod to X(Leyawiin Default: 3)
set DDREBanQ.skiBanMod to X(Skingrad Default: 2)


======================================================================


Requirements
------------

Oblivion patched to version 1.2
Shivering Isles (Unless you use the no SI version)

======================================================================


Known issues
------------

None


Compatibility
-------------

This mod is not compatible with Open Cities.
If you fast travel into a city, the entrance restrictions are bypassed so it is recommended to disable fast travel
or refrain from fast travelling into cities, this mod itself does not take care of this.

If you don't have the Shivering Isles expansion you should use the No SI version.
Beware of overwriting the original file as they are named the same!

======================================================================


Credits and Thanks
------------------

Bethesda Softworks for the game
Everyone at BGS forums who have helped with ideas, suggestion and shown appreciation for what I do.
You, for downloading this mod and hopefully having fun with my work.

======================================================================


Legal
-----

The usual rules apply...

If you want to use anything from this mod in your own work you are free to do so and do not need to ask for permission.
All I ask is that I am credited for my work where appropriate.

======================================================================


Version History
---------------

1.0 -> 1.1 - 2008-04-12
- Fixed a few bugs:
The message telling you how many days you have left on your ban when talking to gate guard was bugged.
Chorrol gates were not included in the script, you could go through them even though you were banned.
Escaping from jail also meant escaping from the temporary ban.
The bounty for breaking a ban was bugged.
- Removed the accidental OBSE dependancy

1.0 - 2008-04-08
First release

======================================================================

Have fun!
DuggeDank