Dynamic Item System v1.0.0 (Mar2015)

[Coincident]

Dynamic Item System / Dynamic Armor System



This is a mod that lets you pickup anything at any time.
Feed the OCD monster in you! Pickup every item before leaving for the next level, and get 100% items!
Don't worry about that large medkit if you have 99 health.
Don't worry about that green armor, if you have 50 points of a blue armor.
DO WORRY about killing the monsters: this mod takes care of the rest.

The Dynamic Item System addresses a design problem where items are often wasted near the item limit.
It is an experimental mod, aimed at improving your experience/interface with the game.
Nothing really changes gameplay-wise. You can play doom just like you used to.
Ideal for difficult, fast-paced games, like nightmare with respawning monsters (works with respawning items).
The goals are:
1 - You should focus ONLY on moving fast and killing everything.
2 - You should NOT worry about the items at your feet, or the order in which you pick them up.
3 - You should not need to go back and look for supplies, because you already have all the supplies with you.

Press and HOLD the USE KEY to NOT pickup anything, if you REALLY want to save an item for later.

---

With this mod you can pickup anything, there are no longer hard limits, only "soft limits".
You can pickup ammo after the reaching the maximum ammo capacity.
You can pickup medkits and armor even after you reach 200/200 health armor.

For example, you can pickup 10 Stimpacks at 100 health.
However, that will NOT give you 200 health. That would be WAY out of balance!
The "soft limit" means that, after 100 health, the Stimback will give less and less health.
So, the mod is balanced with diminishing returns: the more health you have, the less you receive.
At 100 health, a Stimpack gives only 5 health.
At 150 health, a Stimpack might just give 1 health.

Every amount in the game decreases acording to the second half of a gauss curve.

The curve will converge towards zero, but never reach absolute zero.
Worst case scenario, a Stimpack will at least have a chance of giving 1 health.
So, you will still waste part of your pickups, but not as much as in regular doom.

This applies to all pickups: weapons, ammo, health, armor, and powerups.

You can, for example, pickup a green armor with 200 points of a blue armor.
This will give you about 230 armor. But, obviously, the armor absortion% does not reduce.

This mod introduces a new Dynamic Armor System for armor absortion%.
The armor type (green, blue) does not matter. The armor amount determines the absortion%.
A damaged blue armor (50 points), will absorb% less damage than a brand new green armor (100 points).
A green armor + 20 armor bonuses (120 points) will absorb% more than just a green armor (100 points).
The more armor you have, the more damage it absorbs% (max absorb = 66.67%).

---

Increasing armor absortion also has diminishing returns.
From 50 armor to 100 armor (+50), the absorb% will increase from 29% to 40% (+11%).
From 150 armor to 200 armorb (+50), the absorb% will increase from 46% to 50% (+4%).

The absorb% follows a curve that converges towards 66.67%, but never reaches that value.

k is a constant that determines the growth speed of the curve. It is based on what the current mod's
values for the blue armor (or equivalent). For doom, k = 4445.56, which guarantees that f(200) = 50.

The green armor provides more absorb% from 66 to 100, but less absorb from 0 to 66.
It is a little bit weaker, overall.
The blue armor provides the same absorb% at 200, but much less aborb from 0 to 200.
It is a lot weaker, overall.
Armor is weaker on purpose; to balance out for getting more total amor (and health) with this mod.

Works with GZDoom v2+ (you can download it from the DRD Team Forums)

DynamicItemSystem v1.0.0
Supports the current mods: Doom, MiniSphere (load AFTER any supported mods)

DI-Smooth patch
Dynamic Items patch for Smooth Doom - full support (load AFTER DynamicItemSystem.pk3)

DI-Brutal19 patch
Dynamic Items patch for Brutal Doom v19 - full support, including all mutators (load AFTER DynamicItemSystem.pk3)

DI-BDSE patch
Dynamic Items patch for Brutal Doom SE - full support, including all mutators (load AFTER DynamicItemSystem.pk3)

(All decorate and ACS sources are included in the pk3; feel free to copy any code you need)

---

1 - Choose a name for you mod, for example "MyMod":
Load your mod in an ACS script:

Code: Select all

#library "MyScript"
#import "DynaItemSystem.acs"
#include "zcommon.acs"

script "myInitScript" ENTER {
	if (!isInitialized()) {
		loadMod("MyMod", 10);
	}
}

loadMod(modName, priority) will load your mod with the given priority (from 1 to 32).
Mods with a higher priority have their items spawned first (Doom has a fixed priority of 0).

2 - Replace an existing item, with DECORATE:
Create an actor that must extend DynamicItem (or DynamicWeapon / DynamicPowerup).
Give the item effects in the DynamicPickup state, but do NOT use the Pickup state.

Example (taken from brutal doom) - a Minigun to replace the doom regular chaingun:

Code: Select all

ACTOR EmptyMini_Gun : WeaponGiver {
	Weapon.AmmoGive1 0
	DropItem "Mini_Gun"
}
ACTOR MyModChaingun : DoomChaingun {
	Inventory.PickupSound "CBOXPKUP"
	Inventory.PickupMessage "Minigun"
	States {
		DynamicPickup:
			TNT1 A 0 A_GiveInventory("EmptyMini_Gun", 1)
			TNT1 A 0 A_Jump(256, "GiveAmmo")
		GiveAmmo:
			TNT1 A 0 ACS_NamedExecuteWithResult("giveClipAmmo", 30.0 * 65536)
			Stop
	}
}

After running in ACS loadMod("MyMod", 10), the system makes this item spawn automatically.
Do NOT use the replace keyword: the system uses the name of the actor to replace stuff.
"MyMod" is the mod prefix, and "Chaingun" is the item being replaced.
If no actor with the mod prefix is found, the system spawns the regular doom chaingun.

In the DynamicPickup state, use the following script names to give stuff:

Code: Select all

ACS_NamedExecuteWithResult("giveClipAmmo", int amount)
ACS_NamedExecuteWithResult("giveShellAmmo", int amount)
ACS_NamedExecuteWithResult("giveRocketAmmo", int amount)
ACS_NamedExecuteWithResult("giveCellAmmo", int amount)
ACS_NamedExecuteWithResult("giveBackpack")
ACS_NamedExecuteWithResult("giveInvulnerabilitySphere", int tics)
ACS_NamedExecuteWithResult("giveBlurSphere", int tics)
ACS_NamedExecuteWithResult("giveRadSuit", int tics)
ACS_NamedExecuteWithResult("giveInfrared", int tics)
ACS_NamedExecuteWithResult("giveAllMap")
ACS_NamedExecuteWithResult("giveHealth", int amount, int limit)
ACS_NamedExecuteWithResult("giveArmor", int amount, int limit)

All amounts are decimal, so to give 30 something, you must write 30.0 * 65536
All tics are integers, and 35 tics = 1 second, so to give 30 seconds, you must write 30 * 35
All limits are integers, so to give a Soulsphere you must write ("giveHealth", 100.0 * 65536, 200)

3 - Create a drop item that gives half ammo / any other reward:
To define an item drop that can be dropped by monsters and only give half the rewards, use:

Code: Select all

ACTOR MyModChaingunDrop : MyModChaingun {
	States {
		GiveAmmo:
			TNT1 A 0 ACS_NamedExecuteWithResult("giveClipAmmo", 15.0 * 65536)
			Stop
	}
}

The system will auto-detect the drops, and use the "Drop" suffix in the actor name to spawn the right item.
This is optional; if no actor with the "Drop" suffix is found, the system spawns the regular item.

4 - Create a new item, with DECORATE:
First, define the item with the correct name like in step 2.
Then, create a DynamicItemSpawner, for the system to recognize the new item:

Code: Select all

ACTOR DynamicRifleSpawner : DynamicItemSpawner replaces Rifle {}

Again, the name of the actor is important: always prefix with "Dynamic", and suffix with "Spawner".
What's left in the middle? "Rifle" - the name that the spawner will use to find items by mod.
In this case, the spawner will spawn a "MyModRifle", or "MyModRifleDrop" if a zombieman dropped the item.

5 - Create a new backpack, with DECORATE:
Example: the definition of the regular doom backpack:

Code: Select all

ACTOR DoomBackpack : DynamicItem {
	Game Doom
	SpawnID 144
	Height 26
	Inventory.PickupMessage "$GOTBACKPACK"
	States {
		DynamicSpawn:
			BPAK A -1
			Stop
		DynamicPickup:
			TNT1 A 0 A_JumpIf(CallACS("giveBackpack"), "DoubleAmmoCapacity")
			TNT1 A 0 A_Jump(256, "GiveAmmo")
		DoubleAmmoCapacity:
			TNT1 A 0 ACS_NamedExecuteWithResult("doubleClipAmmoCapacity")
			TNT1 A 0 ACS_NamedExecuteWithResult("doubleShellAmmoCapacity")
			TNT1 A 0 ACS_NamedExecuteWithResult("doubleRocketAmmoCapacity")
			TNT1 A 0 ACS_NamedExecuteWithResult("doubleCellAmmoCapacity")
			TNT1 A 0 A_Jump(256, "GiveAmmo")
		GiveAmmo:
			TNT1 A 0 ACS_NamedExecuteWithResult("giveClipAmmo", 10.0 * 65536)
			TNT1 A 0 ACS_NamedExecuteWithResult("giveShellAmmo", 4.0 * 65536)
			TNT1 A 0 ACS_NamedExecuteWithResult("giveRocketAmmo", 1.0 * 65536)
			TNT1 A 0 ACS_NamedExecuteWithResult("giveCellAmmo", 20.0 * 65536)
			Stop
	}
}

CallACS("giveBackpack") only returns true on the first backpack being given.
In that case, it doubles the ammo capacity and gives ammo. Otherwise, it just gives ammo.

6 - Create a new ammo type, with ACS:
All you have to create is a 1-line ACS script with the right ammo name, and then call that script from DECORATE.
Here are a few examples from brutal doom SE:

Code: Select all

#import "DynaAmmo.acs"
script "giveNewClipAmmo" (int amount) {
	giveDynamicAmmo("NewClip", amount);
}

You might also need this for the backpack:

Code: Select all

script "doubleNewClipAmmoCapacity" (int amount) {
	doubleAmmoCapacity("NewClip");
}

7 - Configure a different armor absorb ratio, with ACS:
By default, the Dynamic Armor System uses a 50% absorb at 200 armor (default from doom).
To configure a different absorb value for a mod, follow this example (from brutal doom):

Code: Select all

#library "MyScript"
#import "DynaItemSystem.acs"
#import "DynaArmorSystem.acs"
#include "zcommon.acs"

script "myInitScript" ENTER {
	if (!isInitialized()) {
		loadMod("MyMod", 10);
		configLargeArmorAbsorb(70.0);
		configLargeArmorAmount(200);
	}
}

This means that, in brutal doom, at 200 armor, 70% damage will be absorbed.
The higher the configLargeArmorAbsorb, the more armor is effective.
The higher the configLargeArmorAmount, the less armor is effective.

---

Code: Select all

DynaMath.acs:
	Some auxiliary math functions

DynaItemSystem.acs:
	Some more math functions
	Mod loading system, by priority
	Ammo factor detector that works with any mod / difficulty level
	Item-spawning system; uses loaded mods; spawns dropped versions of items automatically

DynaArmorSystem.acs:
	Dynamic Armor Absortion System implementation (some more math here)
	Damage-calculation loop; supports healing + taking damage on the same tic
	IDKFA detection loop (same loop as above), to give the player the right stuff

DynaAmmo.acs:
	Giving ammo + backpack (uses detected ammo factor) with the dynamic system

DynaPowerups.acs:
	Giving powerups + allmap with the dynamic system
	
DynamicItemSystem.dec:
	DynamicItemSpawner pattern, that waits for init scripts / load mods
	DynamicItem pattern, that auto-detects drop items, sets count items, and stops pickup when pressing USE

---

v1.0.0 (28 Mar 2015)
First release

I hope you enjoy this weird experiment of a "mod" (even if you're just stealing code )
Have fun.

CREDITS
Coincident - All ACS, DECORATE, mod patches, addon conception and design.
BlueShadow - The original idea behind the damage-calculation loop.
The ZDoom team and community - ZDoom
id Software - Doom

[Ozymandias81]

Another brimmyfully mod done by Coincident. What a math headache in it!

[Exeor]

Seems really interesting but when I load Sperglord Edition + DynamicItemSystem + DI-BDSE patch in Gzdoom I get this error:

Script error, "DynamicItemSystem.pk3:dynamicitemsystem.dec" line 47:
"WEAPONSPAWN" is an unknown flag

What im doing bad?

[Coincident]

I just tested that scenario, and it works on my machine.

http://zdoom.org/wiki/Actor_flags#WEAPONSPAWN
WEAPONSPAWN (development version 6d4eb7f6 only)

Which version of GZDoom are you using? Try updating, it should fix the problem.

Edit: I just tested a few versions, it works with GZDoom version 2+, but not with version 1.8+

You can download GZDoom v2.0.05 here:
http://forum.drdteam.org/viewtopic.php?f=23&t=6482

[Exeor]

I was using the 1.8.02 version, now it works perfectly, thanks

[Ozymandias81]

So Coincident, need any graphics/sprites for this DIS?

[Coincident]

So Coincident, need any graphics/sprites for this DIS?

Well, not for the DIS itself, because it only transforms already-existing mods.
So, it just uses the graphics that already exist in those mods.

Other than that, I just hacked that fat backpack + red armor together to make a minimalist icon.
But if you're feeling artistic and can think of a cool title image, that would be nice

[Ozymandias81]

OK Coincident, I'll go for it tomorrow then. This evening I've a massive boardagamin' sessions 'till 4am!!

PS: Just got some ideas, don't worry about it

[Ozymandias81]

And that's my fine banner idea: ta-daan!

---

[Coincident]

I'm sorry Ozy, but that was wayyy overboard... it's just too much.
I'll keep it as it is now.

But thanks for the intention though

[Arctangent]

I feel like this conflicts with its purpose, as while it does allow someone who worries about wasting items to pick up all items, it does so by ... wasting the item.

I mean if you pick up a stimpack and only get 1 health, you're wasting 90% of that stimpack. I don't really see how this is supposed to aid its intended audience at all.

[Josh771]

I feel like this conflicts with its purpose, as while it does allow someone who worries about wasting items to pick up all items, it does so by ... wasting the item.

I mean if you pick up a stimpack and only get 1 health, you're wasting 90% of that stimpack. I don't really see how this is supposed to aid its intended audience at all.

Yeah, I was kinda hoping this would be an auto-inventory that activated carried pickups as they became viable (like every time you are at least 10 rounds below your clip capacity, you use a carried clip automatically).

...which is something I may have to do on my own for personal use, now that I think about it.

[Coincident]

I mean if you pick up a stimpack and only get 1 health, you're wasting 90% of that stimpack. I don't really see how this is supposed to aid its intended audience at all.

The idea is that:
1 - If the stimpack is only giving you 1 health, you're probably at 150+ health, so it shouldn't be a big deal if you're wasting 90% of it.
2 - You might go on a next level / thru a pass of no return. In that case, it's better to trade a stimpack for a health bonus than just get nothing at all.
3 - If it's really really a big deal, or you're not going thru a pass of no return, just hold the USE key and you won't waste the stimpack.

Personally, I find it useful to play on very-fast paced game modes (like nightmare), where I literally don't want to worry about any items.

But I understand what you mean.
As I stated in the first post, it's just an experiment.

[Nash]

Impressive! Will have to give this a spin later.