The DarkMod Wiki - User contributions [en]

User:VanishedOne

2022-03-12T03:02:27Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

Archive.org idDevNet link: [https://web.archive.org/web/20200613234848/https://www.iddevnet.com/doom3/]

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- see [[Xrays]]. (No mention of RoE's "skin_head_xray" spawnarg; use skin_xray on the head entity instead.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- see [[Xrays]].

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
Do vertex colours work with deforms? [http://idtechforums.fuzzylogicinc.com/index.php?topic=514.msg5664#msg5664]
----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

Used the old ARB backend. megaTexture material token is commented out in current Material.cpp.

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

DiversityPeriod -- [https://wiki.thedarkmod.com/index.php?title=Particles#DiversityPeriod]

softeningRadius -- [https://wiki.thedarkmod.com/index.php?title=Particles#SofteningRadius]

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that. (Footprints in Written In Stone use sys.projectDecal() instead.)

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg ('powered-up knockout, not used' according to a def file comment).

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2022-03-12T03:01:18Z

VanishedOne: /* FX */

VanishedOne's notes and queries.

Archive.org idDevNet link: [https://web.archive.org/web/20200613234848/https://www.iddevnet.com/doom3/]

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- see [[Xrays]]. (No mention of RoE's "skin_head_xray" spawnarg; use skin_xray on the head entity instead.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
Do vertex colours work with deforms? [http://idtechforums.fuzzylogicinc.com/index.php?topic=514.msg5664#msg5664]
----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

Used the old ARB backend. megaTexture material token is commented out in current Material.cpp.

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

DiversityPeriod -- [https://wiki.thedarkmod.com/index.php?title=Particles#DiversityPeriod]

softeningRadius -- [https://wiki.thedarkmod.com/index.php?title=Particles#SofteningRadius]

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that. (Footprints in Written In Stone use sys.projectDecal() instead.)

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg ('powered-up knockout, not used' according to a def file comment).

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2022-03-06T17:16:14Z

VanishedOne:

VanishedOne's notes and queries.

Archive.org idDevNet link: [https://web.archive.org/web/20200613234848/https://www.iddevnet.com/doom3/]

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- see [[Xrays]]. (No mention of RoE's "skin_head_xray" spawnarg; use skin_xray on the head entity instead.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
Do vertex colours work with deforms? [http://idtechforums.fuzzylogicinc.com/index.php?topic=514.msg5664#msg5664]
----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

Used the old ARB backend. megaTexture material token is commented out in current Material.cpp.

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

DiversityPeriod -- [https://wiki.thedarkmod.com/index.php?title=Particles#DiversityPeriod]

softeningRadius -- [https://wiki.thedarkmod.com/index.php?title=Particles#SofteningRadius]

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg ('powered-up knockout, not used' according to a def file comment).

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2022-03-06T17:11:31Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

Archive.org idDevNet link: [https://web.archive.org/web/20200613234848/https://www.iddevnet.com/doom3/]

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- see [[Xrays]]. (No mention of RoE's "skin_head_xray" spawnarg; use skin_xray on the head entity instead.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
Do vertex colours work with deforms? [http://idtechforums.fuzzylogicinc.com/index.php?topic=514.msg5664#msg5664]
----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

Used the old ARB backend. megaTexture material token is commented out in current Material.cpp.

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

DiversityPeriod -- [https://wiki.thedarkmod.com/index.php?title=Particles#DiversityPeriod]

softeningRadius -- [https://wiki.thedarkmod.com/index.php?title=Particles#SofteningRadius]

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg ('powered-up knockout, not used' according to a def file comment).

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2022-03-06T17:09:11Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

Archive.org idDevNet link: [https://web.archive.org/web/20200613234848/https://www.iddevnet.com/doom3/]

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- see [[Xrays]]. (No mention of RoE's "skin_head_xray" spawnarg; use 'set skin on head' instead.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
Do vertex colours work with deforms? [http://idtechforums.fuzzylogicinc.com/index.php?topic=514.msg5664#msg5664]
----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

Used the old ARB backend. megaTexture material token is commented out in current Material.cpp.

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

DiversityPeriod -- [https://wiki.thedarkmod.com/index.php?title=Particles#DiversityPeriod]

softeningRadius -- [https://wiki.thedarkmod.com/index.php?title=Particles#SofteningRadius]

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg ('powered-up knockout, not used' according to a def file comment).

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2021-04-06T22:54:40Z

VanishedOne: /* Particles */

VanishedOne's notes and queries.

Archive.org idDevNet link: [https://web.archive.org/web/20200613234848/https://www.iddevnet.com/doom3/]

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- ported as of TDM 2.08. Previous comment was: some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

A token called 'inclusive' seems to have been added to TDM's xrayRenderMap:

ts->dynamic = DI_XRAY_RENDER;
//ts->width = src.ParseInt();
//ts->height = src.ParseInt();
ts->width = 0;
if ( src.ReadTokenOnLine( &token ) ) {
if ( !token.Icmp( "inclusive" ) ) {
ts->width = 1;
}
}

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
Do vertex colours work with deforms? [http://idtechforums.fuzzylogicinc.com/index.php?topic=514.msg5664#msg5664]
----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

Used the old ARB backend. megaTexture material token is commented out in current Material.cpp.

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

DiversityPeriod -- [https://wiki.thedarkmod.com/index.php?title=Particles#DiversityPeriod]

softeningRadius -- [https://wiki.thedarkmod.com/index.php?title=Particles#SofteningRadius]

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg ('powered-up knockout, not used' according to a def file comment).

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2021-04-06T22:54:06Z

VanishedOne: /* Particles */

VanishedOne's notes and queries.

Archive.org idDevNet link: [https://web.archive.org/web/20200613234848/https://www.iddevnet.com/doom3/]

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- ported as of TDM 2.08. Previous comment was: some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

A token called 'inclusive' seems to have been added to TDM's xrayRenderMap:

ts->dynamic = DI_XRAY_RENDER;
//ts->width = src.ParseInt();
//ts->height = src.ParseInt();
ts->width = 0;
if ( src.ReadTokenOnLine( &token ) ) {
if ( !token.Icmp( "inclusive" ) ) {
ts->width = 1;
}
}

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
Do vertex colours work with deforms? [http://idtechforums.fuzzylogicinc.com/index.php?topic=514.msg5664#msg5664]
----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

Used the old ARB backend. megaTexture material token is commented out in current Material.cpp.

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

DiversityPeriod -- [https://wiki.thedarkmod.com/index.php?title=Particles#DiversityPeriod]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg ('powered-up knockout, not used' according to a def file comment).

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

Doors

2021-03-13T03:11:26Z

VanishedOne: /* Initially Blocking a Door - Partially or Fully */

{{todo}}
''Written by Fidcal'' ''edit Baddcog''

==Quick Summary==

Quick way to get an unlocked door in your map:

* Insert one of the prefab doors complete with handles and select its skin property and click the button to change its skin appearance to whatever you want. Set any other properties you need.

Alternatively,

* Create a door from the entity list
* Use the "skin" spawnarg on the door to change its appearance.
* Create a handle from the entity list
* Add the ''door_handle'' property to the door and give it the name of the handle
* To the door handle add the value frob_peer and use the name of the door.
* To open clockwise, change the ''rotate'' property from <code>0 90 0</code> to <code>0 -90 0</code>

==Introduction==

This tutorial explains how to put doors into your map using Dark Radiant, as well as adjust them and their properties.

The rest of this tutorial assumes that you have a basic understanding of using DarkRadiant. If you haven't done so, please go read the [[Dark Radiant Must Know Basic Intro]] article first.

Additionally:

* Up, down, right, and left in Dark Radiant's ''top'' orthoview are regarded here as the standard map directions of North, South, East, and West where useful for clarity.
* Where the term ''brush'' is used with a door it mostly also applies to a door made up of a group of brushes and/or patches.
* Where the term ''door'' is used it often will also apply to any object you wish to rotate when frobbed, for instance an openable window, box lid, or even more exotic objects that the imaginative mapper might conceive like a signal, engine part, toy, or whatever. So long as it needs to turn or slide just a fixed amount when frobbed then return when frobbed again then the following applies.

==Door types==

All tangible objects in Dark Mod are ''entities'', having either a pre-made model shape or else brush/patch(es). So there are two ways to create a door in Dark Radiant: as a model door or a textured brush door (or a hybrid of the two).

Models are ready made door objects but cannot within Dark Radiant (at the time of writing) be resized, rescaled, cropped or clipped whereas brushes are very flexible in that respect and can be worked into custom shapes for your map, including secret doors that blend into walls and other surfaces.

Most of the current door models are found in two places along with the door handles.
*Model Viewer: doors created from here will be static in the world and have no props other than material type.
You can add any props to them to make them working doors. If nothing else it is a good place to view the different size and skin options for the doors.
*Entity List: most of the door models can be found here. These doors have properties already assigned so they are ready to be used. Only one base door of each type is listed, create the size/hinge count door you want (2 hinge doors have a 'no hinge' skin). You can choose a skin for the door once it has been created in the editor with the "skin" spawnarg (use the model name of the door you want, taken from the model list, as its value). This is the easiest way to create a door. The same goes for door handles.

Remember also that door functions may be applied to objects other than doors, such as openable windows, drawbridges, gates, etc. In fact, anything that needs a partial rotation or slide when frobbed then return when frobbed again, such as a signal device. Lockboxes and chests use similar properties.

You can create one door/handle set and copy/paste it, but you need to take great care that all the name props are changed to match in each clone. Otherwise you get handles that fly off when a distant door moves, and handles that don't move.

==Creating a Door==

Put simply, to make a door you will be creating an 'entity with model' or 'entity with brush' or some variation thereof.

===Creating a Model Door===

There are several approaches to making a model door; the simplest is to create a door from the entity list; or create a door from the model viewer (good for static unusable prop doors).

'''Entity List''':

*Deselect everything in editor by hitting the Esc button
*Right-click an ortho view and select Create Entity
*Navigate to darkmod/movers/''atdm:door_...'', choose the door you want
*Click Add
*To change its appearance, add a "skin" spawnarg to the door, with the value being the model name of the door you want.

You now have a workable door in your level.

'''Model Viewer''':

* Right click in the orthoview, select ''Create Model'' then <code>darkmod</code> and select a door.
* Note that you can left drag the image in the ''Choose Model'' dialog to rotate it around.
* Click [[Image:Button ok.png]] and you have a static door.
* If you want to make it work (openable, frobbable) then:
** Select the entity inspector,
** Select the top classname line so it highlights
** Select the func_static line in the input box ''below'' the properties window.
** Edit <code>func_static</code> to <code>atdm:mover_door</code>
** Click {{check}} or press {{key-enter}}

Alternatively you can do it the old way:

* Create any temporary brush
* Right click in orthoview and select <code>Create Entity</code> then <code>atdm:mover_door</code>.
* Left lick the model name line in the entity inspector.
* Below it on the ''Entity Inspector'' panel you should now see a button 'Choose Model'
* Left click it, select a door model from the darkmod group.
* Note that you can left drag the image in the ''Choose Model'' dialog to rotate it around.
* The temporary brush was deleted.

In all three instances, you now have a working door with default properties.

Name your door by adding the prop (or modifing it) to name ''My_Door_1''. You can use any name that you feel is appropriate but all doors with handles attached ''must'' have their own specific name. Use the name My_Door_1 for your first attempt as it will be referenced when you get around to attaching handles (see below).

To add a handle and other adjustments, see [[#Customising and Adjusting Door Properties]] below.

===Creating a Textured Brush Door===

'''Tip:''' If unsure of size then you might insert a temporary human AI first to get a sense of height.

==== The simplest brush door: ====

* Drag out a new brush to the size required, eg, a seven foot high door is 84" x 1.1 = about 90 units in Dark Radiant.
* Give it a door texture from the texture browser (or wall texture for a secret door)
* Right click in orthoview and select ''Create Entity'' then <code>atdm:mover_door</code>

You now have a working door but it will rotate around its center. To move the rotation point to where you want the door hinges to be:
* Select the door and press 'v' to enter vertex editing mode. The door's origin will show up as a small green square in the middle of the brush.
* In top-down orthoview, move the origin from the center to the corner of the brush. This is easiest in drag mode ('q'), although you can use translate mode ('w') by manually selecting the vertex first.

==== Multi-brush doors: ====

More complex multi-brush doors can be created using the [[Clipper]] tool, CSG, etc. - this is not covered in this tutorial. Then assign <code>atdm:mover_door</code> for that whole brush structure. Also you can collect various brushes positioned together in relation to one another as needed, select them all, then assign <code>atdm:mover_door</code> for the group. All the brushes will be children of the <code>atdm:mover_door</code> entity and will rotate and be frobbable, etc. as one unit, as one door. To add further brushes or even model shapes later see the section on [[#Adding handles and other items to doors]].

Name your door by adding the prop (or modifing it) to name My_Door_1. You can use any name that you feel is appropriate but all doors with handles attached must have their own specific name. Use the name My_Door_1 for your first attempt as it will be referenced when you get around to attaching handles (see below). (repeated from above in case you didn't choose to create a model door)

=== Double Doors ===
Double doors are automatically recognised by the code when the doors are spawned. The prerequisite is that both doors are sharing/touching the same visportal. The spawnarg ''auto_setup_double_door'' (which defaults to "1") will take care of setting up the open/lock peer relationship between the two doors. The doors will open/close and lock/unlock along with each other as a result.

What happens behind the scenes: the doors are adding each other to their internal open_peer and lock_peer list, which causes the double doors to perform the same action when frobbed or used.

Note that ''auto_setup_double_door'' will not set the frob_peer relationship, i.e. each door will frob-highlight on its own without highlighting the other door. You'll need to add that spawnarg manually if you want to highlight the entire double door as one.

==Customising and Adjusting Door Properties==

Handles, lockplates, etc. can be added to doors and door properties can be adjusted for rotation, sliding, locking, and more.

Some of the door models have hinge plates and lockboxes that are reskinnable with a good variety of skins.

===Door handles and other door attachments===

'''Summary: just add the property ''bind'' with the door's name to the attachment and position it where you want it on the door. If it's a ''atdm:mover_door_handle'' then it automatically will work as a handle but you can bind virtually anything.'''
You can add handles and other items to doors such that they move correctly with the door whether rotating, sliding, or both and even if the door is not vertical such as a skylight or trapdoor.
Handle models come in two types, ''single handles'' and ''double handles''. A single handle is one sided, this means the handle will be inside the door or outside the door, but not both. A double handle has a lever on the inside of the door and a handle on the outside of the door. Each has benefits.

*'''''Single door handles''''':
Single door handles can be used on a static door, a door that's just for show that no AI's or the player can use. In this case you should just create a door handle from the model viewer, it will be static and have no properties such as scripts. It is for looks only. Note that TDM is trying to establish the expectation that decorative doors that cannot be opened do not have handles (though not all maps follow this).

I will call this ''multiple handles'', see more below.

These can also be useful on brush doors created in the editor that may be very thin or very wide.

*'''''Double door handles''''':
These are models have have a handle inside and outside. The bonus is that they only use one entity. Maps are limited to about 4,000 entities but when you count lights, AI, sound speakers, ect... you can run out of entities quickly on a large map. If you plan on building a large map this is the way to go, even in a small map they have benefits, namely that you only have to attach one handle per door.

Whether you decide to use a single handle or a double handle you must first follow the instructions below and attach one handle first. If you choose a double handle, follow the instructions below and you are done. If you choose a single handle type follow the instructions then also follow the ''multiple handle'' instructions for the second handle.

Both single and double handle types can be found in two places. The model viewer which will create a static model good for show, you can manually add props to make them work OR you can look in the entity browser.
Using a handle from the entity browser saves you a little bit of time as some props are already added, you just need to add the frob_peer names for the doors/handles and the door_handle name to the door.

=== Adding a working model door handle===

Quick summary:
* Create a model or brush handle and make it an ''atdm:mover_door_handle'' entity.
* Position it on your door. Use the opposite side from the door's multicolor X-Y-Z indicator (highlight the door to see it) if it's not obvious which side it goes on.
* '''Bind''' the handle to the door (bind <doorname>)
* It should now be a working handle though may need adjustments of rotation etc. see later.

Important: read preceding section on door handle types and performance issues first.

This works with both a model door and a brush door:

'''Rotation''':
* By default the door handle entity rotates ''anti-clockwise'' (looked at from the front) then springs back. A ''double handle'' model is OK but two singles (see ''Multiple door handles'' below) need more care as only one is the functioning entity and the other is just attached to it. So anti-clockwise is fine for a door with its hinge on the left and the handle on the right - the handle will rotate down then spring back. If you put the functioning door handle on the other side you will have to change the default ''rotate'' property from -45 0 0 to 45 0 0. '''''Therefore it is easier to generally put this handle on the side of the door where the hinge is on the left and the non-functioning attachment handle on the other side.'''''
*If your door only needs one handle, eg, a cupboard door, and from outside its hinge is on the right then you will need to change the ''rotate'' property of the handle as described above.

'''''The functioning handle entity:'''''
* Create an entity door handle (movers folder) or create a brush or model handle and assign it the entity ''atdm:mover_door_handle''.
* Position it where you wish on your door.
* '''Bind''' the handle to the door, by adding the "bind" spawnarg to the handle.

You now have a working door handle with default properties.

*'''Multiple door handles''':
Now that you've got a handle attached to one side of the door it is time to add one to the other side (unless you used a double handle).
* Create the new handle. The single handles come in left and right persuasions. A door needs a left facing handle on one side and a right facing handle on the other, so if you have already added the left handle create a right handle and line it up on the other side of the door.
* Name this handle. I prefer to keep a naming convention for each door and it's respective handles, it makes things alot easier. The door is named '''My_Door_1''', the first handle is named '''My_Handle_1''' so name the second handle '''My_Handle_1_1'''. This will make it stay with the first handle in the entity list. This is important to keep organized. If you name it My_Handle_2 then when you get to another door named My_Door_2 you'll be confused.
* Place and '''bind''' that handle to your door.

You now have two single door handles on either side of the door that rotate together as if they were physically attached.

'''To add a brush to a brush door''':
* Select the new brush ''and'' the brush door all together; ''the entity '''must''' be selected '''last'''.''
* Use {{menu|Edit|Reparent primitives}}. This ensures the parent entity adopts the new item(s).
* If you have trouble selecting them in the orthoview because other brushes, etc. get selected then try in the camera view or as a last resort move them temporarily to an open area (but keep them in the same positions relative to each other.) Use {{key-shift}}+{{LMB}} on new item(s) then {{key-shift}}+{{LMB}} on main entity. Once they are all selected, use the {{menu|Edit|Reparent primitives}}.

'''To add ''model'' static items''': knockers, hinges, static handles etc. to a ''Model Door'':
* Select item
* Right click in orthoview and select ''Create Entity'' then <code>entity func_static</code>
* Position it where you wish on your door.
* To synchronize this with your particular door you need to add the property ''bind'' and the individual door name to the brush entity. To do this...
** Select the model door.
** In the entity inspector, select the ''name'' line
** Select the bottom line in the input box ''below'' the properties window.
** Copy the name
** Deselect the door with {{key-esc}}
** Select the brush entity
** Add a property "bind" to it.
** Change the value of the property by pasting in the door name
** Click {{check}} or press {{key-enter}}

'''To add ''brush'' static items''': knockers, hinges, static handles to a Model Door:
* This method is not ideal but it seems to work OK.
* Select the brush.
* Right click in orthoview and select Create Entity then ''atdm:mover_door_handle''
* Position it where you wish on your door.

To synchronize this with your particular door you need to add the property ''door_handle'' on the door, and give as the value the name of the brush you just created.

This brush turns like a handle. To stop it:

* Adding ''rotate 0 0 0'' or disabling the handle script won't help.
* Add a real working handle (as in the section above ''To add a working model door handle...'' and it must be added LAST.)

If you don't want too see a real working handle added maybe try another tiny brush with the handle function and hide it inside the door?

===Locking Doors===

To lock a door check the ''show inherited properties'' in the entity inspector for a ''atdm:mover_door'' entity and you should see the ''locked'' property. Select it and in the input box below the properties you can change its value:

* 0 = unlocked (default)
* 1 = locked

If locked it will require an entity that is associated with it to be able to act as a key to unlock it.

Currently door handles on locked doors will rotate when frobbed, they will bounce back though and the door will stay locked until unlocked.

===Keys===

Assigning specific keys to specific doors is simple.

* It is recommended that you create an existing key entity. These keys have all required props, they just need to be named.

Alternatively you can create a key from the Model Viewer and want it to be useable
* Make sure it has the properties:
useable 1 [so it can be used by the door]
frobable 1
inv_name <unique name>
inv_category Keys
inv_target player1
inv_icon guis/assets/hud/inventory_icons/<icon name>
inv_stackable 0 or 1 where 1 can be used on all copies of the same key so they show as one entry in the inventory with a total.

Add to the door the property <code>used_by</code> with the name of the key as the value. Multiple keys can open the same door by using several <tt>used_by</tt> spawnargs:

"used_by" "doorkey_1"
"used_by1" "doorkey_2

==== Keys carried by AI ====

So you have a door and you have a guard AI and you want the guard to be able to open/close/lock the door, but you also want the player to be able to pickpocket the key. Keys can be attached to AI in two ways.

''The Def_Attach Method''. This uses spawnargs to spawn the key at game start.

*"def_attach6" "atdm:prop_silverkey" // the entity to spawn - in this case a key.
*"pos_attach6" "belt_back_right" // where the key will spawn on the Ai.
*"name_attach6" "door_key" // this gives 'attach6' arg the name "door_key" and is the name the arg "used_by" will need, eg: "used_by" "door_key"
*"set inv_name on door_key" "Door key" // The name the key get when the play adds it to their inventory.
*"set name on door_key" "door_key" // here it gets a name to be used in the map in general.

For more info on this method, see [[Attaching Props to AI]].

''The Bind Method''. This lacks the animation finesse of def_attach, but does let you see the key in DR. The method is particularly helpful in, say, adding a second key to an AI in the back middle of a belt.

* load a key entity
* position where you want it in relation to the AI, and bind it to them (i.e., "bind" "<AIname>")
* Add the spawnarg "bindToJoint" "Hips" (or another location like LeftHips_Dummy; see AI for list)
* adjust existing spawnargs accordingly (that is, be sure the name and door's/chest's "used_by" match, if you aren't using a prefab chest w/key)

For more info on this method, see [[Attaching_Items]] and [[BindToJoint]].

====Master Key for Testing====

By default, ALL locks can be opened by any key named ''key_master''. Just create a key in your map, name it ''key_master'' and it becomes a master key for use while testing. Add inv_map_start 1 to it so it is in the player inventory at game start. Remember to delete it when your mission is finished.

===Lockpicks===
''by Baddcog''

There are two lock pick types.
*'''s'''=snake
*'''t'''=triangular

A lock can be set with many pins. Each pin has a click sequence and each needs a designated lockpick type (see above). Keep in mind that the lockpicking in The Darkmod is much more involved than in T2 or T3. The player has to listen to sounds or watch a handle or lockbar to know when a lock is pin is picked.

This means that authors can be very evil and really frustrate the player, in which case their missions will probably not be played. So be nice to the player and don't waste your time. Use simple locks for the most part and save complicated locks for important sections and to build tension. Don't make the player have 20 pins to pick all with different lockpicks. In most cases 1 or 2 pins will suffice and it isn't necessary to use both lockpicks on every lock.
Also try to include a lock lever on lockboxes or chests, door handles will rotate as the pins are being picked. This gives the player visual clues to help with the picking (and essential in noisy environments where you can't hear the clicks.)
IMO this system is a huge leap foward for lockpicking but also has the ability to completely frustrate the player as stated above. Keep this in mind when designing your lockpick systems.

These props go on the door itself, or the lid of a chest, eg,
*'''lock_pins''' 1327
*'''lock_picktype''' stts

The lock_pins property specifies how many pins each lockpicktype has.
The lockpick_type property specifies how many times the player has to switch picks and which pick they have to use. You can see there must always be an equal number of lock_pins and lock_picktypes specified

So looking at the example above we have lockpick_type s(snake), t(triangular), t(triangular), and s(snake). The player will have to use these lockpicks in this order. Once the snake lockpick's pins are open the player can advance to the triangular pick and so forth.
5 is added to every click sequence so 5 is the minimum click pattern even if you set it to 0.
In the example above the lockpins specify in order which pick types have how many pins, so the s pick has 1 + 5 = 6 clicks, the t pick has 8 and so on.
The above is a difficult lock and to avoid annoying the player it is best only used rarely on a special lock like an important big vault door. Ordinary footlockers and common doors can be just 1 or 2 click sequences, eg, lock_pins 2 and lock_picktype t means the player uses one pick and listens for the end of one sequence of 7 clicks.

lockpick_rotate - is placed on the door. It is the amount the visible rotating handle or pin rotates while picking. For a rotating handle or lockbar normally ignore this and leave the default. During lockpicking it oscillates and progresses to the normal full turn of the handle. Example 0 45 0.

lockpick_translate - is placed on the door. It is the amount the visible handle or pin moves in a straight line while picking. Use this if you have eg, a lockbar that you want to move in a straight line and not rotate, eg sliding catch. Example 0 -5 0

By default, doors are pickable. If you don't set up the above lockpick spawnargs then it can't be picked. So there is normally no need to enable lockpicking - just set up the above spawnargs. There is a ''pickable'' spawnarg set to 1 by default. If set to 0 then the door becomes unpickable. But hard to think of an application except in testing or perhaps a special custom situation where it is switched by script perhaps.

===Open, Partially Open, or Closed Door at Game Start===

By default, doors are closed at game start. If you want a door to be already open or partially open then do the following.

'''Note well: Create all doors in their ''closed'' position. Adjust as follows and they will automatically be at the open position when game starts.'''

Already Open Rotating Door:
* Select the door.
* Select the entity inspector
* Check ''show inherited properties''
* Select the ''open'' property
* Edit the value to 1 in the input box below and tick the check button
* The door will now be fully open at game start.

* If you want it only partly open:
* Make sure its ''open'' property is set to 1 as above.
* Right click the entity inspector and select ''add property''
* Click the + sign on the left of the top line where atdm:mover_door is listed to open the folder. (if atdm:mover_door is not listed then the entity was likely changed from eg, func_static. If so, save the map and reload to update the add property list)
* scroll down, select ''start_rotate'' then click {{ok}}
* This adds it to the property list.
* Now select ''start_rotate'' in the property list.
* Edit the bottom line of the input box ''below'' the properties window to the angle you want in the same form as described in the ''Rotate Direction and Open Angle'' section. So for example, to have a door that has a fully open default ''rotate'' value of 0 90 0 to start only half open you would give it a ''start_rotate'' value of 0 45 0.
* In a similar way add the property ''first_frob_open".
* Set it to 1 and a partly open door should then open fully on the first frob.
* Set it to 0 and a partly open door should close on the first frob.

Already Open Sliding Door:
* Select the door.
* Select the entity inspector
* Check ''show inherited properties''
* Select the ''open'' property
* Edit the value to 1 in the input box below and click {{check}} or press {{key-enter}}
* The door will now be fully open at game start.

* If you want it only partly open:
* Right click the entity inspector and select ''add property''
* Make sure its ''open'' property is set to 1
* Click the + sign on the left of the top line where atdm:mover_door is listed to open the folder.
* scroll down, select ''start_position'' then click OK. (if atdm:mover_door is not listed then the entity was likely changed from eg, func_static. If so, save the map and reload to update the add property list)
* This adds it to the property list.
* Now select ''start_position'' in the property list.
* Edit the bottom line of the input box ''below'' the properties window to the position you want in the same form as described in the ''Sliding (Translation) Amount and Direction'' section. So for example, to have a door that has a fully open default ''translate'' value of 0 50 0 to start only half open you would give it a ''start_position'' value of 0 25 0.
* In a similar way add the property ''first_frob_open".
* Set it to 1 and a partly open door should then open fully on the first frob.
* Set it to 0 and a partly open door should close on the first frob.

===Rotation Centre, Pivot, Hinge point===

The centre of rotation of a door is at the origin point of its entity and the door rotates with reference to the orientation of that origin point, not the world map. See ''Rotate Direction...'' for more about that. This section only deals with the ''position'' of the rotation centre in the door.

Model Door Centre of Rotation: 
The centre of rotation of a model door cannot be changed within Dark Radiant. Because a model door rotates around the centre 'spine' of its back edge this will cause clipping (penetration into solid) as in this example (where the door is set to open to 89 degrees for clarity): [[Image:modelClipping.jpg]] So care is needed with placement. You will not normally position a door right next to a wall as in the example but against a shallow frame so clipping will barely be noticeable but either way it can be fixed. You can correct it by adding a translation (see ''Sliding (Translation) Directions'') value of half the door width in the direction of the door handle. This will gently move the door out as it rotates to clear any solid on that side as in this diagram: 
[[Image:DoorClip.jpg]] 
Half a door width will typically be about 2. Any 'attachments' such as door handles will still synchronize with the door movement whether the door is rotating, sliding, or both.

Brush Door Centre of Rotation: 
The centre of rotation of a brush door ''can'' be changed. The default origin point of a brush is at its centre. Therefore a default rotating brush door will rotate around its centre when you first create it. So, mappers will commonly need to move that rotation point to a corner or even to some other offset position for example, for an openable window using the door function.

Put simply, to move the rotation point of a brush door you need to move the entity origin relative to the brush(es.)

Moving the entity origin (centre of rotation) relative to a brush door:

* Select the brush door
* Select ''Vertices mode'' (default shortcut key is {{key|name=V}} or button on top toolbar 'Select Vertices')
* Drag the door's entity origin to the point where you want the door to rotate. This should be on the corner on the leading edge side (the side to where the door is opening.) to avoid clipping as in this diagram....
[[Image:getCorner.jpg]]
* You should now find that door rotates around that point.

===Rotate Direction and Open Angle===

By default, rotating doors open anti-clockwise (viewed from above) by 90 degrees from the start orientation. If you want to change this edit the ''rotate'' property in the entity inspector. Don't confuse this ''rotate'' property with the ''rotation'' property. In the entity inspector remember that to see the inherited rotate property you must check the box 'Show inherited properties'.

The three values shown in the rotate property are degrees from the closed position around Y Z X (absolute map axes Front, Top, Side views in DR's ortho view.)

* Positive Y = Open clockwise (Dark Radiant grid front view, looking north)
* Negative Y = Open anti-clockwise (Dark Radiant grid front view, looking north)

* Positive Z = Open anti-clockwise (Dark Radiant grid top view, looking down)
* Negative Z = Open clockwise (Dark Radiant grid top view, looking down)

* Positive X = Open anti-clockwise (Dark Radiant grid side view, looking west)
* Negative X = Open clockwise (Dark Radiant grid side view, looking west)

There is a problem when you come to rotations that are not around the main Y Z X axes of the map, for instance a drawbridge that lowers down to the south east. You might think you can combine Y Z X values to get the result you want - and this can be done (for south east use 45 45 90) but it is a bit of a kludge and the drawbridge twists eccentrically as it lowers (though it arrives correctly!)

The values are in the range -179 to +180. Positive values give an anti-clockwise opening rotation (looking down from above) and negative values give a clockwise opening rotation. The value 180 is unique in that it continues in an anti-clockwise rotation when closing rather than returning clockwise so might be used if you can think of some object that might need such a motion when frobbed!

Edit the rotate value by selecting it and using the input box at the bottom and clicking the check(tick) button. That will change the angle the door will open to. Note that the line with the original default of 0 90 0 will still be there but your new entry will be added on a separate line and that is the one that will work in the game. CAUTION: when adjusting later make sure you have your new line selected and not the original! If you do it will appear to change but your first setting will remain unaltered.

Examples:
* 0 90 0 = Opens anti-clockwise round the entity's 'vertical' to 90 degrees - typical default vertical door.
* 0 0 90 = Lowers a drawbridge from the entity 'vertical' to horizontal.
* 0 0 -45 = Opens clockwise by 45 degrees viewed from the east side. This might suit a skylight in a sloping roof.

'rotate' cannot be combined with translate motions (see [[#Sliding (Translation) Amount and Direction]]) in one door; you need to bind one door to another and link they by targetting one to the other. By that means you can produce exotic and useful motions. A door opening against an upward-sloping floor can thus have a ''lifting hinge'' and raise up slightly to clear the floor; a door can rotate towards you and slide back to one side very effectively.

===Sliding (Translation) Amount and Direction===

By default a Dark Mod door will rotate open. For most sliding doors you want to stop them rotating as well as make them slide. You cannot delete (remove) the ''rotate'' property - you have to set the ''rotate'' property to 0 0 0 to stop a door rotating (see ''Rotate Direction and Open Angle''.)

Now edit the ''translate'' property value by selecting it (remember to have inherited properties box checked) and using the input box at the bottom and clicking the check(tick) button. That will change the distance the door will slide to. Note that the line with the original default of 0 0 0 will still be there but your new entry will be added on a separate line and that is the one that will work in the game. CAUTION: when adjusting later make sure you have your new line selected and not the original! If you do it will appear to change but your first setting will remain unaltered.

Typically (but not always) you will want your sliding door to slide the width of the door. The three values in the translate property by default are 0 0 0 and are X Y Z ''absolute map'' values (irrespective of door orientation) where:

* Positive X = Slide East (Right side of Dark Radiant grid in top view)
* Negative X = Slide West (Left side of Dark Radiant grid in top view)
* Positive Y = Slide North (top of Dark Radiant grid in top view)
* Negative Y = Slide South (bottom of Dark Radiant grid in top view)
* Positive Z = Slide Up (Top of Dark Radiant grid in side views)
* Negative Z = Slide Down (Bottom of Dark Radiant grid in side views)

So for a 50 unit wide door you want to slide fully to the east you would use 50 0 0 for the translate property values. A 100 unit portcullis sliding vertically up would need 0 0 100 to be fully raised.

=== Doors Collision/Push Behaviour ===
Doors push all entities by default, except for the player. Doors will also stop moving when anything blocks their movement. However, this default behaviour can be changed by setting appropriate spawnargs:

Set '''push_player''' to '''1''' to let the player be pushed by this door:
"push_player" "1" // Push the player too (default is off)

By default '''stop_when_blocked''' is set to 1 and if a door is blocked by an entity then even if the entity is removed afterwards, the door stays where it is. The next frob will close the door.

Set '''stop_when_blocked''' to '''0''' to prevent the door from ending the opening sequence when anything blocks its way. It will still pause - but continue to open if the block is removed.
"stop_when_blocked" "0" // door keeps moving after being blocked (default is off)
With this setting, doors will still stop at blocking entities (the player, for instance), but will continue to move when the entity moves out of the way.

There is another spawnarg which stops a door pushing a moveable. Apply this to the ''moveable'', not the door...

"notPushable" "1"

===Door Sounds===

There are multiple ways to put sounds on doors.

''snd_open'' 
Sound is triggered as the door begins to open.

''snd_opened'' 
Sound is triggered when the door finishes opening. Defaults to "nosound".

''snd_move'' 
The sound plays while the door moves. Defaults to "nosound".

''snd_close'' 
Sound is triggered as the door finishes closing.

The following sounds should be left on the default sound in most cases so players clearly know what is going on:

''snd_locked'' 
The sound played when a player or an AI tries to open a locked door.

''snd_unlock string'' 
The sound played when a door is unlocked.

You can silence any of these sounds by setting the following properties as shown:

''snd_open nosound'' 
''snd_close nosound''

Don't just use a dash - as it seems to cause a sound of its own.

===Sound Propagation through Doors and Doorways===

''This information will change significantly with the release of 2.0. See'' [[Controlling Sound Loss Across Portals]]

The sound volume reduction to the player (ie, the sound the player hears) is fixed and constant in a cvar which adds a distance factor to the original sound. It is recommended that you do not change that because it will affect other FMs. Currently there is no way to change the way that sound to the player is reduced through doors and doorways.

Sound propagation to AI, eg, impact sounds or guard yells is treated separately:

Sound propagation to AI relies on visportals. For details study [[Sound Propagation: Part 1]] and [[Sound Propagation: Part 2]] as well as [[Visportals]] This tutorial will just cover the relevant sound and sound propagation ''properties'' of doors. If you set the ''show inherited properties'' box in the entity inspector you can see them as described here.

Remember, the following have no effect on what the player hears through a door or doorway.

''loss_open'' 
Drop in sound volume in dB propagated to AI (not player) when going through an open door. (default 1dB)

''loss_closed'' 
Drop in sound volume in dB propagated to AI (not player) when going through a closed door. (default 15dB) You would want to set this very high to block all sound with a thick door but very low for a barred gate for example.

''loss_double_open'' 
Drop in sound volume in dB propagated to AI (not player) when going through double doors when only one is open. (default 1dB)

There are also various sound properties for lockpicking: 
''snd_lockpick_pin_1 through 14'' and ''snd_lockpick_pin_success''

===Speed of Door Opening and Closing===

Rotating Door Speed: 
At the time of writing, the time a rotating door takes to open or close is set in the ''move_time'' property whatever its maximum open angle. So with rotation set at say 150 degrees the door just opens faster than at say 80 degrees. This is likely to be changed to a constant angular velocity so check to see if there a new property added if the following no longer works. The problem is that if an interruptable (see Extra Notes) door is frobbed while in motion it stops; another frob will reverse the motion - so even if the door is only open a crack it will still take the full time to close and vice versa.

To change the time a rotating door takes to open or close, make sure the door is selected then...

* Right click the entity inspector and check ''show inherited properties''
* Scroll down, select ''move_time''
* Edit the second line of the input box ''below'' the properties window to the time you want.
* The time is in seconds and decimal fractions can be used.
* The default is 1 second and if set to this then the door opens and closes in one second whatever the maximum open angle, great or small.

Sliding Door Speed: 
The speed of a sliding door is set in the ''translate_speed'' property. To add this, make sure the door is selected then...

* Right click the entity inspector and check ''show inherited properties''
* Scroll down, select ''translate_speed''
* Edit the second line of the input box ''below'' the properties window to the speed you want.
* The speed is in Dark Radiant grid units per second.
* The default is 0 and if set to this then the door slides open in one second whatever the distance, great or small.
* CAUTION: If you later change the door back to a rotating door then delete the ''translate_speed'' property or ensure it is set to 0 as (at the time of writing but this will be fixed) a bug makes rotating doors open and close instantly. (Note: you can still mix sliding with rotating but check - this bug might only be if ''translate'' is set to 0 0 0)

===Visportals and Doors===

A visportal face surrounded by solid at its edges and in contact with a door is closed when the door is closed and enabled when the door is open. In most cases you will place a visportal in contact with a working door unless you can see through the door (such as a true glass door or barred gate*.) For full details see [[Visportals]].

''*As of 2.0 it is possible to make visportals that remain transparent when closed for gates and windows. See'' [[Controlling Sound Loss Across Portals]]

==Auto-Closing/Opening Doors==
Doors that automatically close after being open for some time are easy to setup: Each frobmover entity supports these spawnargs:

;"auto_close_time":Set this to something >= 0 to let the mover automatically close (again) after this time when being fully opened (measured in seconds). Defaults to -1, which means 'do not autoclose'. The event is also activated when the mover starts at the open position at map start.
;"auto_open_time":"Set this to something >= 0 to let the mover automatically open (again) after this time when being fully closed (measured in seconds). Defaults to -1, which means 'do not autoopen'. The event is also activated when the mover starts at the closed position at map start.

Old text:

Note that auto-closing doors and AI closing doors behind them, is very much work in progress at the time of writing, so for now, this is another method that works. Check first if true AI closing of doors is working yet before bothering with this!

I have one door that I particularly want the AI to close as there is a bit of frame lag inside if not. So I set this up and it works good as an auto-closing door - not as good as a true AI closing door as it will auto close when the player goes through as well but it does look very effective to see AI going through and closing the door behind them. Not tested exhaustively so I don't know if there could be any downside. Here's what to do....

First a quick summary to make it more clear:

'''''A trigger_relay is used both as a relay AND carries a stim. We put the trigger_relay with its stim in the path of the open door. The door has a response property. When it opens and contacts the stim its response is to send a signal back to the relay. The relay pauses then closes the door...'''''

* First, optionally give your door a suitable name like autodoor1, whatever.
* Copy that name to the clipboard.

Next we need a relay with a delay:

* Create entity > darkmod > trigger_relay

* Place it roughly at the position the door will be at when open and to be on the safe side 3/4th of the way to the far end of the door (not the hinge end) to give max distance from the close door.

* Add the property 'target' and paste in the door name you just copied.

* Give the relay itself a name, eg, autoDoor_relay_1, and copy that name to the clipboard, you'll need that too in a bit.

* Add the property delay and the value 3 - this is the delay in seconds before the door will close; 3 seems about right but 2 might be worth a try because to that 3 is added a random value between 0 to 0.5 seconds from the Time Interval we entered for the stim firings.

* Add the property 'wait' and the value 3. This is the time before it can work again in seconds. If you set it too low then in theory the door might trigger again but in this situation I don't think it's possible. Too long, eg, one minute, and it won't work if the AI goes back through the door before then. If this value is -1 then the whole thing will only work ONCE so might be used for an AI who goes through once, closes it behind him, but you don't want it to be an autodoor thereafter.

That's the relay, now we add a stim to it:

* Still with the trigger relay selected, go to {{menu|Entity|Stim/Response}}

* Custom stim tab.

* Click Add stim type, select the new custom stim type you just made at the bottom of the list and type in eg, autoDoorStim at top right in the input box.

* Click the stim tab and the little drop down arrow against the 'type' selector at bottom left and you should see your new custom stim name. Select it.

* Select the new autoDoorStim in the list and on the right you need only type in the radius box 15.0 There is quite a lot of room for error. I had it working on 10 and also on 25. The value should be less than the distance to the closed door else it will trigger open! But no so small that the door might not reach it.

* Select the check box for Time Interval and enter 500 (millisecs.) This is so it doesn't keep firing more frequently than is necessary. This stim will be firing all through your mission whether the door is used or not so if you had dozens of these then maybe it would affect performance. Too big a number and there may be a long delay before the door shuts - but it will be random depending on the next time the stim happens to fire. We'll control the delay we want more precisely later.

* Click {{ok}} to confirm it.

That's the stim set up, now for the response to it which is put on the door....

* Select the doorm, then use {{menu|Entity|Stim/response}} and select the response tab.

* Click the little drop down arrow against the 'type' selector at bottom left and you should see your new custom stim name. Select it.

* Right click in the big ''Response Effects'' box on the bottom right of the panel.

* Add New Effect and you should get a default 'Activate Response' response added to the list. Double click it.

* In the Effect selector at the stop select 'Trigger'

* in the Target box, paste in the name of the relay you copied or you can select it from the list at the little arrow.

* Leave the Activator box empty.

* Click {{apply}} and then {{ok}} on the main S & R panel bottom right.

It should now work. No need to wait for an AI, just frob the door and watch it close itself. If not, check the position of the stim brush is close to where the door stops when open.

==AI Door management==

By default AI will open doors and close them behind them. Here are some spawnargs the mapper can use to modify that behaviour:

;"ai_should_not_handle" :If set to 1, AI will not attempt to handle it and add it to the forbidden areas when closed (so that it doesn't try to path through). They might still walk through the door when it is open though. Useful if you have some special use door that you don't want the AI to operate.

;"ai_should_not_close" :If set to 1, AI will not close the door behind them unless it obstructs them.

;"canRemainOpen" :If set to 1, it's the same as "ai_should_not_close, with the added behavior that this is ignored if the door needs to be relocked, or the door is marked "shouldBeClosed". '''(This spawnarg is available starting in TDM 2.02.)'''

To get AI to unlock/relock specific doors there are two methods:

1. Provide the AI with the key, as detailed in [[#Keys_carried_by_AI]] above.

2. Add the following spawnarg/value to the AI:

;"can_unlock1" ''<doorname>''

'''Do NOT use can_unlock_1.'''

For additional doors on the same AI use ''can_unlock2 doorname'' etc.

If both (1) and (2) are used, then the AI can still go through the door after the player pickpockets the key. Otherwise, unless someone else opens the door for the AI, a typical sequence is that the AI checks their pockets for the missing key, stalls a bit at the locked door, and then (with now-better pathing algorithms) the AI uses an alternate route to the next path_corner, or "mentally" skips ahead in the route to next reachable node and goes there.

===Door Handling Positions===

It is also possible to set custom door handling positions for the AI. This is especially useful when the standard routine that lets the AI choose their standing positions while opening and closing the door fails, leaving them standing still, or circling around in front of the door helplessly.

Place a movers > ''atdm:door_handling_position'' entity where you want the AI to stand while opening/closing the door from this side.

On the door, you need to set the spawnarg "door_handle_position" "name_of_door_handling_position". You can also place a ''door_handling_position'' on each side of the door, and the AI will automatically choose the right one. In this case, you need to set spawnargs with "door_handle_position_1" etc., and the corresponding names of the ''door_handling_position'' entities on the door.

The ''door_handling_position'' entities can also carry spawnargs that define the behaviour of the AI, which are useful for example for doors that can only be opened or locked from one side:

'''"ai_no_open"''' If set to true, the AI will not try to open the door from this side (but will still walk through when the door is already open).

'''"ai_no_close"''' If set to true, the AI will not attempt to close the door from this side.

'''"ai_no_unlock"''' If set true, the AI will not be able to unlock the door from this side, but still use it when it is not locked.

'''"ai_no_lock"''' If this is set true, the AI will not lock the door from this side.

===Door Controllers===

'''Available in TDM 2.02+'''

You can design a door so it's operated by buttons or levers or switches (aka ''controllers''):

1. Set up the door in the normal manner. It can be a rotating door, a sliding door, a locked door, etc.

2. Turn off the "frobable" spawnarg on the door. ("frobable" "0")

3. Create a controller on each side of the door. If you're setting up a locked door, there's no need to put any locking information on the controllers.

4. Give each controller the door as a target. (Alternatively, you can give the door these spawnargs: "door_controller1" "<name of controller 1>", "door_controller2" "<name of controller 2>".)

When the game starts, it will transfer any locking information from the door to the controllers.

Both the player and any AI that wants to use the door will use the controllers to operate it. Any key, "can_unlock", or lockpick settings you would normally use at the door are now used at the controllers.

Controllers and ''door_handling_position'' entities can be used on the same door, but in that situation the ''door_handling_position'' entities don't define where the AI stands to operate the door. They simply provide the "ai_no_*" spawnargs that define AI behavior on each side of the door.

You may have a controller on only one side of the door. Note that, since the door is not frobable, the player and the AIs won't be able to operate the door from the non-controller side, even if that side has a ''door_handling_position'' entity.

===AI locking doors behind them===

If one AI is involved (no one else is in the queue), he'll lock it behind him if he had to unlock it in the first place.

Prior to TDM 1.08, if more than one AI is using the door at the same time (there's a queue), the first AI unlocks the door, and the last AI through will only lock it if it's marked "should_always_be_locked" AND they have a "can_unlock" for that door or they have a key for that door. The last AI to use the door doesn't know that the first AI found it locked, because that info is kept per AI, and not per door.

Starting in TDM 1.08, if the first AI in a door queue found the door locked, that information is remembered by the door and the last AI through uses it to relock the door, as long as they have a "can_unlock" for that door or they have a key for that door.

In the rare case where a door is set up to use door-handling position entities (necessary for AI to use sliding doors), either or both of those entities can have the "ai_no_lock" spawnarg, which means AI aren't allowed to lock the door from that side.

==Initially Blocking a Door - Partially or Fully==
''by Geep 2021''

Suppose you have a door that you want to start out either as unopenable, or able to open just a crack, then later, after something happens, be fully openable and operational. One method known to work:

* Create a moveable object that the opening door runs into and tries to push.
* Arrange that the far side of the moveable object is jammed against some immovable worldspawn.

Here's two specific examples that use a wooden plank moveable:

* In "Perilous Refuge", a plank blocks the door leading out of the player's starting location, until the player carries it away.
* At the end of "Away0" (WIP 2021), the player tries to open a door. But if preconditions aren't met, the occupant seems to let the door open only a crack and complains. Blockage is done by an unseen plank resting on the floor hitting a knob of worldspawn. Preconditions met causes a "$plank.remove()" script call.

Other methods that you might think would work but don’t:

* Block with a func_static object, or an unjammed moveable with "notpushable 1" set. In both cases, the door travels through the object.
* In advance, "grab" an unjammed moveable to make it appear "solid" to the physics engine. (This was tested by having the player manipulate it; if it had worked, a “grabber” script call might suffice.)
* Dynamically change the door’s "rotate" limit from script using "setSpawnArg"; this function would only work before you spawn the door, not afterwards.

(Others possibilities not yet tested:

* Change "rotate" using the "setKey" script function; for some spawnargs this works even after spawn.
* Create a moveable and bind it to the world entity.
* If you are mainly interested in initially blocking an AI from using a door: it's possible that the AI re-reads the spawnargs for what doors it's allowed to open. Try adding a frob Response to the key (Entity -> Stim/Response... -> Response) with an effect that sets the “can_unlock" spawnarg on that AI to "-".)

==Doors as Triggers==

''by Ishtvan & greebo''

Doors (or any binary frob mover, buttons, levers, etc) now have the option to [[Triggers|trigger]] their target on closing or opening. (For definition purposes, a button is defined as "closed" in the state when it starts out and "open" in the state you press it down to. I know that's a little non-intuitive, but it came from deriving from doors).

New spawnargs on frob movers:
;"trigger_on_open" :If set to 1, this binary mover will trigger its targets when it starts out completely closed and is opened.
;"trigger_when_opened":If set to 1, this binary mover will trigger its targets when it is completely opened. Code defaults to 0.
;"trigger_on_close":If set to 1, this binary mover will trigger its targets when it completely closes after being open.

== Suspicious Doors ==

If you give a door the spawnarg '''"shouldBeClosed" "1"''', then AI will treat it as suspicious if they find the door open.

Doors with that spawnarg should work like this:

- an AI opening the door knows he's not to become suspicious if he opened the door

- nearby AI alerted by the open door will also not react if they can see the door, and can see the AI that opened it

- AI who come upon the open door later probably won't be able to see the AI that opened it, so they'll treat it as suspicious

- if the AI who opened the door comes upon the door later, and it's still open, and no one's touched it since he opened it, he'll see his name on the door and won't become suspicious. "Oh, crap. I forgot to close it earlier."

- If an AI comes upon an open door that should be closed, he should close it whether he becomes suspicious or not.

'''Post TDM 2.00:'''
- AI turn to look at a door they see opening. The player can crack open a suspicious door to peek out w/o grabbing the attention of a nearby AI. After 5s, the AI will notice the cracked open door. Non-suspicious doors can be cracked open indefinitely w/o nearby AI noticing.

==Slanted or Tilted Doors==
Slanted or tilted doors can be made as follows:

1) Place your door, preferrably one of the prefab doors, which have a model door and model handle and all the rotation spawnargs pre-set.

2) rotate and place the door+handle model into place you want it to be. Now, if you use the door in the game, the door will rotate around the world z-axis, and not the door model z-axis (which is rotated).

3) to get the door to rotate around the door model z-axis, you must place a model (any model will do, and it can be placed anywhere in the map). Rotate the new model into the same orientation your door model was rotated, i.e. if you door is rotated 45 degrees around the x-axis, do the same rotation on the new model.

4) bind the doors on the new model. This makes the doors start rotating along the new model origin (which is rotated the same way as the doors).

5) working slanted door.

Do note, that all the rotated objects need to be models (suspicion, not tested). You can export DR built stuff into a model using the DR ase exporter script. For custom doors, remember that the exporter places the model origin at the map origin if you do not choose the "place origin in the middle of the object" option.

Also note that the AI probably cannot use slanted doors and might get stuck (suspicion, not tested).

There is a link to a test map here:
http://forums.thedarkmod.com/topic/9082-newbie-darkradiant-questions/?p=395486

==Skins: A Wide Variety of Door Textures==

This is to remind you that as with many Dark Mod models, there is a wide range of extras skins (textures) available for door models. There are now several basic door entities of different sizes so choose your size first. Then enter the spawnarg: skin with any temporary value. Now select it and click the skin button at the bottom of Dark Radiant's Entity Inspector and you will find a large of range of skin textures from which to select to give you a choice of appearances for your door.

==Extra Notes==
The property ''interruptable'' determines whether a door can be stopped by frobbing while it is opening or closing. So by frobbing then frobbing again, the player can open a door to any position, eg, slightly ajar to peek through.

''func_darkmod_door'' is no longer used (just in case you come across it in the Dark Mod forums or wiki.) '''<code>atdm:mover_door</code>''' is the entity to use.

{{tutorial-editing}}

User:VanishedOne

2021-03-03T14:55:05Z

VanishedOne: /* Misc. */

VanishedOne's notes and queries.

Archive.org idDevNet link: [https://web.archive.org/web/20200613234848/https://www.iddevnet.com/doom3/]

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- ported as of TDM 2.08. Previous comment was: some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

A token called 'inclusive' seems to have been added to TDM's xrayRenderMap:

ts->dynamic = DI_XRAY_RENDER;
//ts->width = src.ParseInt();
//ts->height = src.ParseInt();
ts->width = 0;
if ( src.ReadTokenOnLine( &token ) ) {
if ( !token.Icmp( "inclusive" ) ) {
ts->width = 1;
}
}

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
Do vertex colours work with deforms? [http://idtechforums.fuzzylogicinc.com/index.php?topic=514.msg5664#msg5664]
----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

Used the old ARB backend. megaTexture material token is commented out in current Material.cpp.

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg ('powered-up knockout, not used' according to a def file comment).

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2021-02-23T14:39:56Z

VanishedOne:

VanishedOne's notes and queries.

Archive.org idDevNet link: [https://web.archive.org/web/20200613234848/https://www.iddevnet.com/doom3/]

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- ported as of TDM 2.08. Previous comment was: some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

A token called 'inclusive' seems to have been added to TDM's xrayRenderMap:

ts->dynamic = DI_XRAY_RENDER;
//ts->width = src.ParseInt();
//ts->height = src.ParseInt();
ts->width = 0;
if ( src.ReadTokenOnLine( &token ) ) {
if ( !token.Icmp( "inclusive" ) ) {
ts->width = 1;
}
}

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
Do vertex colours work with deforms? [http://idtechforums.fuzzylogicinc.com/index.php?topic=514.msg5664#msg5664]
----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

Used the old ARB backend. megaTexture material token is commented out in current Material.cpp.

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2021-02-23T00:06:55Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- ported as of TDM 2.08. Previous comment was: some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

A token called 'inclusive' seems to have been added to TDM's xrayRenderMap:

ts->dynamic = DI_XRAY_RENDER;
//ts->width = src.ParseInt();
//ts->height = src.ParseInt();
ts->width = 0;
if ( src.ReadTokenOnLine( &token ) ) {
if ( !token.Icmp( "inclusive" ) ) {
ts->width = 1;
}
}

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
Do vertex colours work with deforms? [http://idtechforums.fuzzylogicinc.com/index.php?topic=514.msg5664#msg5664]
----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

Used the old ARB backend. megaTexture material token is commented out in current Material.cpp.

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2021-02-22T23:56:42Z

VanishedOne: /* Megatextures */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- ported as of TDM 2.08. Previous comment was: some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
Do vertex colours work with deforms? [http://idtechforums.fuzzylogicinc.com/index.php?topic=514.msg5664#msg5664]
----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

Used the old ARB backend. megaTexture material token is commented out in current Material.cpp.

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2021-02-20T23:29:30Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- ported as of TDM 2.08. Previous comment was: some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
Do vertex colours work with deforms? [http://idtechforums.fuzzylogicinc.com/index.php?topic=514.msg5664#msg5664]
----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

(Will this even work with the ARB backend gone, i.e. does it only require megatexture.vfp to be replaced with megatexture.vs/fs?)

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

Talk:Material Files

2020-08-21T16:30:04Z

VanishedOne: Created page with "Is a stage for the simple ambient still needed, now that the corresponding menu option is gone in 2.08? --~~~~"

Is a stage for the simple ambient still needed, now that the corresponding menu option is gone in 2.08? --[[User:VanishedOne|VanishedOne]] ([[User talk:VanishedOne|talk]]) 16:30, 21 August 2020 (UTC)

User:VanishedOne

2020-08-18T17:24:19Z

VanishedOne:

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- ported as of TDM 2.08. Previous comment was: some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----
'...using 3D textures. I found code in TDM's source to support loading such images but no corresponding material keyword to invoke it.' [https://forums.thedarkmod.com/index.php?/topic/19606-tdm-engine-wishlist/&do=findComment&comment=426494]
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

(Will this even work with the ARB backend gone, i.e. does it only require megatexture.vfp to be replaced with megatexture.vs/fs?)

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2020-07-31T20:26:58Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- ported as of TDM 2.08. Previous comment was: some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

fogAlpha, sort last -- [https://wiki.thedarkmod.com/index.php?title=What%27s_new_in_TDM_2.08#Mapping]

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2020-03-29T18:45:15Z

VanishedOne: /* GLprogs */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- ported as of TDM 2.08. Previous comment was: some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]
This is due to be made redundant by GLSL newFrob anyway.

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2020-03-29T18:35:41Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- ported as of TDM 2.08. Previous comment was: some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2020-03-29T18:27:58Z

VanishedOne: /* AI */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached. The difference is perhaps linked to the fact that TDM's melee system seems to use AFs for collision checks: if af_push_moveables is disabled the AI is immune to melee attacks (at least from the player; I haven't checked other AI's), which is why you can't melee a rat.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2020-03-27T00:09:42Z

VanishedOne:

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== AI ==

Behaviour noted in [https://forums.thedarkmod.com/index.php?/topic/14066-needed-for-standalone-animated-werebeast/&do=findComment&comment=366434] is not standard for an id Tech 4 game. Typically you don't see AFs when using g_showCollisionModels, and AI without AFs (e.g. the fish in Arx: EoS) don't cause a crash when approached.

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2020-03-26T23:33:37Z

VanishedOne: /* Misc. */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

There's a "kill_all" spawnarg for letting moveables kill AI.[https://bugs.thedarkmod.com/view.php?id=3358]

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2020-03-18T02:14:49Z

VanishedOne: /* Particles */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors (there's some evidence in the Prey SDK that HH fixed this for their engine version).

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

cutoffTimeMap, mapLayout, collisionStatic, collisionStaticWorldOnly -- [[Particle_collisions_and_cutoff]]

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2020-03-18T01:19:18Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. Bump/specular seems to be possible with turbulent but in the wrong, i.e. unchanged, places. (Carmack: '...internally there are a number of things I consider flaws with the Doom engine, for instance, surface deforms, where you have something that's an auto-sprite or uses some other deform, that happens in the wrong place in the pipeline to get lit.' [https://www.gamedev.net/forums/topic/266373-so-i-finally-took-all-of-carmacks-quakecon-speech-and-put-it-to-text-format/])
* Particles spawned from surfaces (except that the simple ambient can add colour to them).
* 'Smoke' particles.

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2020-03-02T20:44:09Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [https://forums.thedarkmod.com/index.php?/topic/11987-ocns-questions-on-tdm-editing/&do=findComment&comment=239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2020-02-29T20:03:18Z

VanishedOne:

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----
Nonsolid response entities, like the candle flames, may need to have "[[Clipmodel contents spawnarg|clipmodel_contents]]" "131072" set. (Do they also need explicit "mins"/"maxs"?)

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2020-02-29T16:41:28Z

VanishedOne: /* Misc. */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

It should be possible to set the player's entity class by setting player_classname on worldspawn.[https://forums.thedarkmod.com/index.php?/topic/9082-newbie-darkradiant-questions/&do=findComment&comment=413393]

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2019-10-12T15:49:41Z

VanishedOne:

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== AAS ==

Apparently AAS can include 'swim reachabilities', but I'm not sure what (if anything) can be done with them. Arx: EoS fish seem to use AAS with both swim and fly reachabilities turned on, use MOVETYPE_FLY (there being no MOVETYPE_SWIM) and have added code to limit their maximum 'flying' height.

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2019-10-12T15:41:22Z

VanishedOne: /* Misc. */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2019-10-12T15:17:44Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor. A variant of shaderdemos/shadowDrawLight is in the leaked D3 alpha build, but while that build accepts the keyword, a shadowDraw light didn't look noticeably different from a regular light when spawned.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

----
Where is ECLASS_EMITTER defined? (Seen in tdm_response_effects.script)

entity newEntity = sys.spawn(ECLASS_EMITTER);

I did find ECLASS_* defs in /tools/radiant/QERTYPES.H but those are editor-related and don't include ECLASS_EMITTER, which is apparently available for scripting use.

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2019-10-12T15:15:07Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] for Prey but I didn't find the string when checking the Prey .exe in a text editor.)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

----
Where is ECLASS_EMITTER defined? (Seen in tdm_response_effects.script)

entity newEntity = sys.spawn(ECLASS_EMITTER);

I did find ECLASS_* defs in /tools/radiant/QERTYPES.H but those are editor-related and don't include ECLASS_EMITTER, which is apparently available for scripting use.

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2019-10-12T15:12:25Z

VanishedOne: /* Stim/Response */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Sent to AI when they've been directed by the Response effect Move To Position or Move To Random Position.

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] so maybe it survived in Prey?)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

----
Where is ECLASS_EMITTER defined? (Seen in tdm_response_effects.script)

entity newEntity = sys.spawn(ECLASS_EMITTER);

I did find ECLASS_* defs in /tools/radiant/QERTYPES.H but those are editor-related and don't include ECLASS_EMITTER, which is apparently available for scripting use.

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2019-10-12T15:05:55Z

VanishedOne: /* Misc. */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Emitted to what?

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] so maybe it survived in Prey?)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

----
Where is ECLASS_EMITTER defined? (Seen in tdm_response_effects.script)

entity newEntity = sys.spawn(ECLASS_EMITTER);

I did find ECLASS_* defs in /tools/radiant/QERTYPES.H but those are editor-related and don't include ECLASS_EMITTER, which is apparently available for scripting use.

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

Fan Missions for The Dark Mod

2019-09-11T16:13:39Z

VanishedOne: Omitting a mission number for Perilous Refuge until it's clear what it is. We have Vitalic Fever listed as 138 but it's http://www.thedarkmod.com/missiondetails/?id=139

__NOTOC__
{{infobox|<center>'''Big Ugly Disclaimer:'''</center> '''The Dark Mod''' team does not necessarily support or endorse content listed here, and only hosts missions listed on the [http://www.thedarkmod.com/ official TDM website]. This is a community maintained list, and an ongoing work in progress. Most of the mirror links in this list are dead or are for missions that are not 2.0 compliant. Mission entries which are suspected to violate copyright must be text-only, and cannot contain links. Report and/or remove links found in violation of this rule.}}

* For details about editing this table, see [[#Editing_this_table|below]].
* For details about how to install Fan Missions please visit: [[Installing and Running Fan Missions]]
* To sort by a different criterion, click the [[Image:Sort none.gif]] icon in the relevant column header.

{|class="wikitable sortable" border=1 style="border-collapse: collapse;" cellspacing=0 cellpadding=2 width=100%
|-
!bgcolor=#d0d0e0 width="21%"|Fan Mission Title
!bgcolor=#d0d0e0 width="11%"|Author(s)
!bgcolor=#d0d0e0 width="4%" class="unsortable"|Links
!bgcolor=#d0d0e0 width="5%"|First Release
!bgcolor=#d0d0e0 width="2%"|Size (MB)
!bgcolor=#d0d0e0 width="3%"|EFX Reverb
!bgcolor=#d0d0e0 width="10%"|Series
!bgcolor=#d0d0e0 width="13%"|Mission Type
!bgcolor=#d0d0e0 width="6%"|Spiders and Undead
|-



|-
!align=left|{{TDM-FM||Perilous Refuge}}
|Dragofer
|{{Forumlink|http://forums.thedarkmod.com/index.php?/topic/20090-fan-mission-perilous-refuge-by-dragofer-20190910/}}
|2019-09-10
|33
|Yes
|
|Ship, City Missions
|
|-

|-
!align=left|{{TDM-FM|138|Hidden Hands: Vitalic Fever}}
|JackFarmer
|{{Forumlink|http://forums.thedarkmod.com/index.php?/topic/20051-hidden-hands-vitalic-fever-20072019}}
|2019-07-20
|269
|Yes
|Hidden Hands 2
|Mansion/Estate
|Spiders, undead
|-

|-
!align=left|{{TDM-FM|137|Chronicles of Skulduggery 2: A Precarious Position}}
|Bienie
|{{Forumlink|http://forums.thedarkmod.com/topic/19975-fan-mission-chronicles-of-skulduggery-2-a-precarious-position-20190504/}}
|2019-05-04
|14.5
|Yes
|[[Fan_Mission_Series#Chronicles_of_Skulduggery_series|Chronicles of Skulduggery]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|136|William Steele 5: Commerce Bank}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19957-fan-mission-commerce-bank-by-grayman-2019410/}}
|2019-04-10
|30
|Yes
|[[Fan_Mission_Series#William_Steele_series|William Steele]]
|Bank Jobs
|
|-

|-
!align=left|{{TDM-FM|135|Marsh of Rahena}}
|ERH+
|{{Forumlink|http://forums.thedarkmod.com/topic/19951-fan-mission-marsh-of-rahena-by-erh-201945}}
|2019-04-05
|60.3
|Yes
|
|Castle/Fortress, Horror
|Undead, Spiders, Horror Themes
|-

|-
!align=left|{{TDM-FM|134|Shadows of Northdale ACT 2}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/19936-fan-mission-shadows-of-northdale-act-ii-by-goldwell-20190320/}} [https://www.youtube.com/watch?v=KO-eIOX9nqI Briefing]
|2019-03-20
|417
|Yes
|[[Fan_Mission_Series#Shadows of Northdale series|Shadows of Northdale]]
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|133|Cleaning Up the Neighbourhood}}
|some1stoleit and Bikerdude
|{{Forumlink|http://forums.thedarkmod.com/topic/19898-fan-mission-cleaning-up-the-neighbourhood-by-some1stoleitbikerdude-20190219/}}
|2019-02-18
|34.3
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|132|Hidden Hands: Initiation}}
|JackFarmer
|{{Forumlink|http://forums.thedarkmod.com/topic/19796-hidden-hands-initiation-27122018/}}
|2018-12-27
|92.5
|Yes
|
|Mansion/Estate Ship
|Spiders, Extra-natural entities
|-

|-
!align=left|{{TDM-FM|131|The Night of Reluctant Benefaction}}
|Bienie
|{{Forumlink|http://forums.thedarkmod.com/topic/19787-fan-mission-the-night-of-reluctant-benefaction/}}
|2018-12-24
|11.9
|Yes
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|130|Mission of Mercy}}
|joebarnin
|{{Forumlink|http://forums.thedarkmod.com/topic/19642-fan-mission-mission-of-mercy-by-joebarnin-20180914/}}
|2018-09-14
|10.1
|No
|
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|129|William Steele 4: The Warrens}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19618-fan-mission-the-warrens-by-grayman-201891/}}
|2018-09-01
|53
|Yes
|[[Fan_Mission_Series#William_Steele_series|William Steele]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|128|Braeden Church}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19533-fan-mission-braeden-church-by-grayman-201871/}}
|2018-07-01
|24
|No
|
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|127|Chronicles of Skulduggery: Pearls and Swine}}
|Bienie
|{{Forumlink|http://forums.thedarkmod.com/topic/19439-chronicles-of-skulduggery-pearls-and-swine/}}
|2018-05-25
|23
|Yes
|[[Fan_Mission_Series#Chronicles_of_Skulduggery_series|Chronicles of Skulduggery]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|126|Shadows of Northdale ACT I}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/19368-fan-mission-shadows-of-northdale-act-i-by-goldwell-20180323/}} [https://www.youtube.com/watch?v=p4nP3lYd6wg Briefing]
|2018-03-23
|295
|Custom (not EFX)
|[[Fan_Mission_Series#Shadows of Northdale series|Shadows of Northdale]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|125|Sir Taffsalot's Sword}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19361-fan-mission-sir-taffsalots-sword-by-grayman-2018318/}}
|2018-03-17
|11.3
|No
|
|Mansion/Estate In memoriam of Gary (Sir Taffsalot) {{Forumlink|http://forums.thedarkmod.com/topic/19306-sad-news-we-lost-one-of-our-own-sir-taffsalot/}}
|
|-

|-
!align=left|{{TDM-FM|124|The Arena}}
|ERH+
|{{Forumlink|http://forums.thedarkmod.com/topic/19350-fan-mission-the-arena-by-erh/}}
|2018-03-12
|3
|No
|
|Arena Deathmatch Experimental
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|123|The Elixir}}
|Bikerdude and Obsttorte
|{{Forumlink|http://forums.thedarkmod.com/topic/19323-fan-mission-the-elixir-by-b1k3rdude-obsttorte-17022018/}} [https://www.youtube.com/watch?v=KfElYZs-FaE Briefing]
|2018-02-17
|112
|Yes
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|122|Volta 2: Cauldron of the Gods}}
|Kingsal
|{{Forumlink|http://forums.thedarkmod.com/topic/19207-volta-ii-cauldron-of-the-gods/}} [https://www.youtube.com/watch?v=SRRCRVFHruc Briefing]
|2017-11-30
|252
|Yes
|[[Fan_Mission_Series#Volta series|Volta]]
|Lost Civilizations
|Undead
|-

|-
!align=left|{{TDM-FM|121|In the Black}}
|VanishedOne
|{{Forumlink|http://forums.thedarkmod.com/topic/19185-fan-mission-in-the-black/}}
|2017-11-18
|103
|No
|
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|120|Accountant 1: Thieves and Heirs}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/19164-fan-mission-the-accountant-1-thieves-and-heirs-by-goldwell-20171108}} [https://www.youtube.com/watch?v=Tk9DtOT4kjc Briefing]
|2017-11-08
|247
|No
|[[Fan_Mission_Series#The Accountant series|The Accountant]]
|Mansion/Estate
|Spiders
|-

|-
!align=left|{{TDM-FM|119|King of the Mountain}}
|Spoonman
|{{Forumlink|http://forums.thedarkmod.com/topic/19105-fan-mission-king-of-the-mountain-by-spoonman-18092017/}}
|2017-09-18
|8.07
|No
|
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|118|Briarwood Manor}}
|NeonStyle
|{{Forumlink|http://forums.thedarkmod.com/topic/18980-fan-mission-briarwood-manor-by-neonsstyle-first-mission-2017-07-11}} [https://www.youtube.com/watch?v=BZnSuLVatYM Trailer] [https://www.youtube.com/watch?v=CPlu8fEzyGM Briefing]
|2017-07-11
|90
|No
|
|Mansion/Estate
|Spider
|-

|-
!align=left|{{TDM-FM|117|A Matter of Hours}}
|Springheel
|{{Forumlink|http://forums.thedarkmod.com/topic/18809-fan-mission-a-matter-of-hours-by-springheel-2842017/}}
|2017-04-28
|13
|No
|[[Fan Mission Series#Corbin series|Corbin]]
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|116|The Ravine}}
|Spoonman
|{{Forumlink|http://forums.thedarkmod.com/topic/18782-fan-mission-the-ravine-by-spoonman-17042017/}}
|2017-04-17
|30.6
|No
|
|Outdoor/Pagan
|Spiders
|-

|-
!align=left|{{TDM-FM|115|The Bakery Job}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/18707-fan-mission-the-bakery-job-by-sotha-20170309/}}
|2017-03-09
|2
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM||Mission 1: A New Job}}
|Springheel
|{{Forumlink|http://forums.thedarkmod.com/topic/18647-tdm-205-official-introductory-missions/}}
|2017-03-14
|13.8
|No
|[[Fan_Mission_Series#Introduction_campaign|Official Campaign]]
|City Missions Inn/Tavern
|
|-

|-
!align=left|{{TDM-FM|114|Coercion}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/18405-fan-mission-coercion-by-sotha-20160927}}
|2016-09-27
|10
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|113|Down by the Riverside}}
|Dragofer
|{{Forumlink|http://forums.thedarkmod.com/topic/18402-fan-mission-down-by-the-riverside-by-dragofer-20160925}}
|2016-09-25
|56
|No
|[[Fan_Mission_Series#Of Brambles and Thorns series|Of Brambles and Thorns]]
|Mansion/Estate Ship Horror
|Horror themes, Undead
|-

|-
!align=left|{{TDM-FM|112|Penny Dreadful 3: Erasing the Trail}}
|Melan and Bikerdude
|{{Forumlink|http://forums.thedarkmod.com/topic/18200-fan-mission-penny-dreadful-3-by-melan-and-bikerdude-20160710}}
|2016-07-09
|200
|No
|[[Fan_Mission_Series#Penny Dreadful series|Penny Dreadful]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|111|Volta 1: Volta and the Stone}}
|Kingsal
|{{Forumlink|http://forums.thedarkmod.com/topic/18087-fan-mission-volta-and-the-stone-by-kingsal-05262016}}
|2016-05-27
|102
|Yes
|[[Fan_Mission_Series#Volta series|Volta]]
|Mansion/Estate City Missions
|
|-

|-
!align=left|{{TDM-FM|110|Full Moon Fever}} (v2.0 2018/02/21)
|Spoonman
|{{Forumlink|http://forums.thedarkmod.com/topic/18066-fan-mission-full-moon-fever-by-spoonman-14052016/}}
|2016-05-14
|21
|No
|
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|109|King of Diamonds}}
|Spooks
|{{Forumlink|http://forums.thedarkmod.com/topic/18064-fan-mission-the-king-of-diamonds-by-spooks-20160513}}
|2016-05-13
|26
|No
|
|City Missions
|Occult themes
|-

|-
!align=left|{{TDM-FM|108|Accountant 2: New in Town}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/18054-fan-mission-the-accountant-2-new-in-town-by-goldwell-20160509/}} [https://www.youtube.com/watch?v=xeuIO_GcYjQ Briefing] [https://www.youtube.com/watch?v=w6e_SJ0_JOM Gameplay trailer]
|2016-05-08
|358
|No
|[[Fan_Mission_Series#The Accountant series|The Accountant]]
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|107|The Smiling Cutpurse}}
|Airship Ballet
|{{Forumlink|http://forums.thedarkmod.com/topic/17850-fan-mission-the-smiling-cutpurse-by-airship-ballet-20160325/}}
|2016-03-25
|87
|No
|
|Mansion/Estate Sewers
|
|-

|-
!align=left|{{TDM-FM|106|Mother Rose}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/17653-fan-mission-mother-rose-by-grayman-20160101/#entry385131/}}
|2016-01-01
|10
|No
|
|Mansion/Estate
|Ghost
|-

|-
!align=left|{{TDM-FM|105|Behind Closed Doors}}
|Bikerdude and the Crucible Team
|{{Forumlink|http://forums.thedarkmod.com/topic/17627-crucible-of-omens-behind-closed-doors-by-bikerdude-the-crucible-team-updated-18122015/}}
|2015-12-19
|359
|Yes
|[[Fan_Mission_Series#Crucible of Omens series|Crucible of Omens]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|103|The Rats Triumphant}}
|Melan
|{{Forumlink|http://forums.thedarkmod.com/topic/17512-fan-mission-the-rats-triumphant-by-melan-20151031/}}
|2015-10-31
|11
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]] (Winner)
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|104|Dead Drunk}}
|Stumpy
|{{Forumlink|http://forums.thedarkmod.com/topic/17511-fan-mission-dead-drunk-by-stumpy-20151030/}}
|2015-10-30
|4
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Tombs, Catacombs & Crypts
|Undead
|-

|-
!align=left|{{TDM-FM|97|Thief's Remorse}}
|Airship Ballet
|{{Forumlink|http://forums.thedarkmod.com/topic/17509-fan-mission-thiefs-remorse-by-airship-ballet-20151030/}}
|2015-10-30
|42
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Tombs, Catacombs & Crypts
|Undead
|-

|-
!align=left|{{TDM-FM|102|Spring Cleaning}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/17510-fan-mission-spring-cleaning-by-goldwell-20151030/}} [https://www.youtube.com/watch?v=JzPpmDK9Fxw Briefing]
|2015-10-30
|45
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Mansion/Estate
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|96|The Golden Skull}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/17497-fan-mission-the-golden-skull-by-sotha-20151024/}}
|2015-10-25
|7
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|101|A House of Locked Secrets}}
|Moonbo
|{{Forumlink|http://forums.thedarkmod.com/topic/17163-fan-mission-a-house-of-locked-secrets-by-gelo-moonbo-fleisher-20150528/}} [https://www.youtube.com/watch?v=f5NuTJEZ8VE Trailer]
|2015-05-29
|195
|No
|[[Fan_Mission_Series#Shadowcursed series|Shadowcursed]]
|Church/Cathedral Mansion/Estate
|Horror themes Undead
|-

|-
!align=left|{{TDM-FM|100|Ulysses 2: Protecting the Flock}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/17162-fan-mission-ulysses-2-protecting-the-flock-by-sotha-20150528/}}
|2015-05-28
|102
|No
|[[Fan_Mission_Series#Ulysses series|Ulysses]]
|Church/Cathedral
|
|-

|-
!align=left|{{TDM-FM|99|Sir Talbot's Collateral}}
|Baal and Bikerdude
|{{Forumlink|http://forums.thedarkmod.com/topic/17093-fan-mission-sir-talbots-collateral-by-baal-bikerdude-15042015/}} [https://www.youtube.com/watch?v=e3rdZfq4Omc Trailer]
|2015-04-15
|60
|Yes
|[[Fan_Mission_Series#Sir Talbot series|Sir Talbot]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|98|Vengeance for a Thief Part 3}}
|Sir Taffsalot
|{{Forumlink|http://forums.thedarkmod.com/topic/16953-the-complete-vengeance-for-a-thief-campaign/}}
|2015-02-16
|25
|No
|[[Fan_Mission_Series#Vengeance for a Thief series|VFAT]]
|Church/Cathedral
|
|-

|-
!align=left|{{TDM-FM|95|Lord Edgar's Bathhouse}}
|Goldwell
|{{Forumlink|1=http://forums.thedarkmod.com/topic/16828-fan-mission-lord-edgars-bathhouse-by-goldwell-27122014/}} [https://www.youtube.com/watch?v=vYSZY7VzFEo Briefing]
|2014-12-27
|71
|No
|Lord Edgar
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|94|Quinn Co.}} (Made into a campaign, 2015/02/04)
|Airship Ballet
|{{Forumlink|1=http://forums.thedarkmod.com/topic/16912-fan-mission-chase-mercantile-by-airship-ballet-20150204/}}
|2014-11-22
|111
|No
|Quinn Co.
|Bank Jobs
|
|-

|-
!align=left|{{TDM-FM|93|Exhumed}}
|Airship Ballet and Kyyrma
|{{Forumlink|1=http://forums.thedarkmod.com/topic/16658-fan-mission-exhumed-by-kyyrma-and-airship-ballet-20141104/}}
|2014-11-04
|24
|No
|[[Fan_Mission_Contests#2014 Halloween Speed-build Contest|HSC 14]]
|Church/Cathedral Horror
|Undead
|-

|-
!align=left|{{TDM-FM|92|Briarwood Cathedral}}
|buck28
|{{Mirrorlink|http://www64.zippyshare.com/v/25705489/file.html}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16644-briarwood-cathedral/}}
|2014-10-29
|7
|No
|[[Fan_Mission_Series#Master thief Corso series|Corso]] [[Fan_Mission_Contests#2014 Halloween Speed-build Contest|HSC 14]]
|Church/Cathedral Horror
|Undead
|-

|-
!align=left|{{TDM-FM|91|One Step Too Far}}
|Dragofer
|{{Mirrorlink|https://www.dropbox.com/s/sfxcap1gfdzf318/onesteptoofar.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16457-fan-mission-one-step-too-far-by-dragofer-20140804/}}
|2014-08-04
|9
|No
|[[Fan_Mission_Series#Of Brambles and Thorns series|Of Brambles and Thorns]]
|Pirate Ship
|
|-

|-
!align=left|{{TDM-FM|90|Lockner Manor}}
|buck28
|{{Mirrorlink|http://www76.zippyshare.com/v/44108372/file.html}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16452-new-mission-lockner-manor/}}
|2014-08-02
|6
|No
|[[Fan_Mission_Series#Master thief Corso series|Corso]]
|Mansion/Estate Inn/Tavern
|
|-

|-
!align=left|{{TDM-FM|89|Ulysses: Genesis}}
|Sotha
|{{Mirrorlink|http://www4.zippyshare.com/v/67195436/file.html}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16428-fan-mission-ulysses-genesis-by-sotha-20140724/}}
|2014-07-24
|98
|No
|[[Fan_Mission_Series#Ulysses series|Ulysses]]
|Mansion/Estate
|Horror theme?
|-

|-
!align=left|{{TDM-FM|88|Penny Dreadful 2: All the way up}}
|Melan and Bikerdude
|{{Mirrorlink|https://mega.co.nz/#!EwoXHZYZ!tE_sKon2h4AWtWPNt9QS3FQClwmXdimhfjIMPcpCQ34}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16387-fan-mission-penny-dreadful-2-by-melan-and-bikerdude-2014078/}} [https://www.youtube.com/watch?v=WmPfCfbeWvg Trailer]
|2014-07-08
|102
|No
|[[Fan_Mission_Series#Penny Dreadful series|Penny Dreadful]]
|Thieves' Highway / Rooftop
|Spiders
|-

|-
!align=left|{{TDM-FM|87|Poets and Peasants}}
|Digi
|{{Mirrorlink|https://drive.google.com/file/d/0B1HHvWAgbWGfTkI0SXFubXZucXM}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16373-fan-mission-poets-peasants-by-digi-62914}}
|2014-06-29
|1
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|85|A Reputation to Uphold}}
|Springheel
|{{Mirrorlink|http://www.mindplaces.com/follow.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16204-fan-mission-a-reputation-to-uphold-by-springheel/}}
|2014-04-18
|25.5
|No
|[[Fan_Mission_Series#Corbin series|Corbin]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|86|Breaking Out the Fence}}
|Kyyrma
|{{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/breakingout.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16091-fan-mission-breaking-out-the-fence-17032014-by-kyyrma/}}
|2014-03-17
|11.6
|No
|[[Fan_Mission_Series#In A Time of Need series|In A Time of Need]]
|City Missions Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|83|Inn Business}} (v.1.48, 2014/03/08)
|RJFerret
|{{Mirrorlink|https://drive.google.com/file/d/0B81T2ZXLPqhTYWVaODRiSExGeGc}} {{Forumlink|1=http://forums.thedarkmod.com/topic/16018-fan-mission-inn-business-by-rjferret-20140303/}}
|2014-03-03
|6
|No
|
|Inn/Tavern City Streets
|
|-

|-
!align=left|{{TDM-FM|82|William Steele 3: Cleighmoor}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/16011-fan-mission-cleighmoor-by-grayman-201431/#entry338349/}}
|2014-03-01
|38
|No
|[[Fan_Mission_Series#William Steele series|William Steele]]
|Sewers Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|81|William Steele 2: Home Again}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/15919-fan-mission-home-again-by-grayman-2014212/page__fromsearch__1}}
|2014-02-12
|26
|No
|[[Fan_Mission_Series#William Steele series|William Steele]]
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|80|The Gatehouse}}
|Bikerdude Goldchocobo
|{{Mirrorlink|http://www.southquarter.com/tdm/fms/gatehouse.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15844-fan-mission-the-gatehouse-by-bikerdude-goldchocobo-20140114/}} [https://www.youtube.com/watch?v=kcIe2Ucojqw Briefing]
|2014-01-29
|100
|No
|Remake of Evilartist's Doom 3 mod
|Castle/Fortress
|Ghosts
|-

|-
!align=left|{{TDM-FM|79|Window of Opportunity}} (v.1.43, 2014/01/01)
|RJFerret
|{{Mirrorlink|https://drive.google.com/file/d/0B81T2ZXLPqhTWTMzQXZtMVFBSG8}} {{Forumlink|1=http://forums.thedarkmod.com/topic/15727-fan-mission-window-of-opportunity-by-rjferret-20140101/}}
|2014-01-01
|7
|No
|
|Outdoor/Caves
|Spiders (not in short mode)
|-

|-
!align=left|{{TDM-FM|78|In A Time Of Need}}
|kyyrma
| {{Mirrorlink|http://www.mediafire.com/download/a97or40t1xrybh3/timeofneed_v1.zip}} {{Forumlink|http://forums.thedarkmod.com/topic/15354-fan-mission-in-a-time-of-need-by-kyyrma-20131112/}}
|2013-11-12
|5.6
|No
|[[Fan_Mission_Series#In A Time of Need series|In A Time of Need]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|76|Requiem}}
|Moonbo
| {{Mirrorlink|http://www.mediafire.com/download/l6o3vvj9y78hu89/requiem.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15101-fan-mission-requiem-by-gelo-moonbo-fleisher-2013106/}}
|2013-10-08
|107.3
|No
|[[Fan_Mission_Series#Shadowcursed series|Shadowcursed]]
|Lost Civilizations Church/Cathedral
|Undead
|-

|-
!align=left|{{TDM-FM|75|Vengeance for a Thief Part 2}}
|Sir Taffsalot
| {{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/vfat2.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15051-fan-mission-vengeance-for-a-thief-part-2-by-sir-taffsalot-06092013/}}
|2013-09-06
|22
|No
|[[Fan_Mission_Series#Vengeance for a Thief series|VFAT]] [[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]]
|Museum Heists
|
|-

|-
!align=left|{{TDM-FM|74|Lords and Legacy}}
|Kvorning
| {{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/lordsnlegacy.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15016-fan-mission-lords-legacy-by-kvorning-20130830/}}
|2013-08-30
|45
|No
|
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|72|Not An Ordinary Guest}}
|Fieldmedic
| {{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/naog.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14965-fan-mission-not-an-ordinary-guest-by-fieldmedic-20130801/}}
|2013-08-01
|79.6
|No
|[[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|71|Penny Dreadful: Grail of Regrets}}
|Melan
| {{Forumlink|http://forums.thedarkmod.com/topic/14952-fan-mission-penny-dreadful-by-melan-20130728/}}
|2013-07-27
|74
|No
|[[Fan_Mission_Series#Penny Dreadful series|Penny Dreadful]]
|Horror
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|70|Solar Escape 1}}
|Tr00pertj
| {{Forumlink|http://forums.thedarkmod.com/topic/14944-fan-mission-solar-escape-1/}}
|2013-07-22
|6
|No
|
|Mansion/Estate Sewers
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|69|The Lich Queen's Demise}}
|Sotha
|{{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/lich_queens_demise.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14826-fan-mission-the-lich-queens-demise-by-sotha-20130520/unread/}}
|2013-05-20
|97.6
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]] [[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]] (Winner)
|Horror
|Undead
|-

|-
!align=left|{{TDM-FM|77|Old Habits Rebuild}}
|Obsttorte
|{{Bloodgate|mc.pk4}} {{Mirrorlink|http://www.mediafire.com/download/u2gwucibh17c45a/oldhabits.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14827-fan-mission-old-habits-rebuild-by-obsttorte-20052013/}}
|2013-05-20
|28.6
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|68|The Builder's Blocks}}
|Jesps
|{{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/builders_blocks.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14592-unusual-gameplay-contest-fm-the-builders-blocks-by-jesps/}}
|2013-03-18
|2.85
|No
|[[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]]
|Experimental
|
|-

|-
!align=left|{{TDM-FM|67|Crystal Grave}} (v.2.0, 2013/02/09)
|ERH+ Bikerdude
|{{Mirrorlink|https://dl.dropbox.com/u/17706561/crystalgravev2.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14510-fan-mission-crystal-grave-v2-by-erh-and-bikerdude-20130209/unread/}}
|2011-11-15
|12.4
|No
|
|Horror
|Undead
|-

|-
!align=left|{{TDM-FM|66|The Builder Roads}}
|Obsttorte
|{{Forumlink|http://forums.thedarkmod.com/topic/14449-fan-mission-the-builder-roads-by-obsttorte-20130119/}}
|2013-01-19
|?
|No
|
|Horror
|Ghosts
|-

|-
!align=left|{{TDM-FM|65|William Steele 1: In the North}}
|grayman
|{{Bloodgate|ws1_north.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14214-fan-mission-in-the-north-by-grayman-20121020/}}
|2012-10-20
|39.8
|No
|[[Fan_Mission_Series#William Steele series|William Steele]]
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|64|Old Habits}}
|Obsttorte
|{{Bloodgate|mc.pk4}} {{Mirrorlink|http://www.mediafire.com/download.php?andes2xnsonssfj}} {{Forumlink|http://forums.thedarkmod.com/topic/14206-fan-mission-old-habits-by-obsttorte-20121019/}}
|2012-10-19
|12.8
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|63|Deceptive Shadows}}
|ShadowHide
|{{Bloodgate|DeceptiveShadows.pk4}} {{Mirrorlink|http://www.sendspace.com/file/jzr9s7}} {{Forumlink|http://forums.thedarkmod.com/topic/14103-fan-mission-deceptive-shadows-by-shadowhide-16sep12/}}
|2012-09-16
|22.4
|No
|
|Outdoor/Pagan
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|62|Vengeance for a Thief: Part 1}}
|Sir Taffsalot
|{{Bloodgate|VFAT1.pk4}} {{Mirrorlink|https://dl.dropbox.com/u/17706561/VFAT1.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14068-fan-mission-vengeance-for-a-thief-part-1-by-sir-taffsalot-06092012/}}
|2012-09-06
|20.9
|No
|[[Fan_Mission_Series#Vengeance for a Thief series|VFAT]]
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|61|The Phrase Book}}
|Sotha
|{{Bloodgate|phrase_book.pk4}} {{Mirrorlink|http://dl.dropbox.com/u/17706561/phrase_book.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13799-fan-mission-the-phrase-book-by-sotha-20120512/}}
|2012-05-11
|24
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|60|In Remembrance of Him}}
|RPGista
|{{Bloodgate|remembrance.pk4}} {{Mirrorlink|http://dl.dropbox.com/u/17706561/remembrance.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13749-fan-mission-in-remembrance-of-him-by-rpgista/}}
|2012-04-22
|27.6
|No
|[[Fan_Mission_Contests#2012_Community_Beginner_Contest|CBC 12]]
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|59|Rightful Property}}
|jysk
|{{Bloodgate|rightful.pk4}} {{Mirrorlink|http://dl.dropbox.com/u/17706561/rightful1.1b.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13711-fan-mission-rightful-property-by-jysk-20120413/}}
|2012-04-12
|22.5
|No
|[[Fan_Mission_Contests#2012_Community_Beginner_Contest|CBC 12]]
|Bank Jobs
|Spiders
|-

|-
!align=left|{{TDM-FM|58|Sneak and Destroy}}
|SeriousToni
|{{Bloodgate|kneipe24.pk4}} {{Mirrorlink|http://minus.com/mVcf61n3G/1f}} {{Forumlink|http://forums.thedarkmod.com/topic/13706-fan-mission-sneak-destroy-by-serioustoni-beginners-contest-2012/}}
|2012-04-11
|158
|No
|[[Fan_Mission_Contests#2012_Community_Beginner_Contest|CBC 12]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|56|House of Theo}}
|Theothesnopp
|{{Bloodgate|houseoftheo.pk4}} {{Mirrorlink|http://www.gamefront.com/files/21053391/houseoftheo__2__2.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13242-fan-mission-house-of-theo/}}
|2011-12-04
|6.2
|No
|
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|53|Dragon's Claw}}
|Bikerdude, Flanders (map assets)
|{{Bloodgate|claw.pk4}}{{Mirrorlink|http://www.gamefront.com/files/20948800/claw.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13181-fan-missiondragons-claw-by-b1k3rdude-31102011/}}
|2011-10-31
|98
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|52|A Night to Remember}} (v2.0, 2018/05/28)
|Fieldmedic
|{{Bloodgate|antr.pk4}} New → {{Forumlink|http://forums.thedarkmod.com/topic/19452-a-night-to-remember/}} Old → {{Forumlink|http://forums.thedarkmod.com/topic/13177-fan-mission-a-night-to-remember-by-fieldmedic-20111030/}}
|2011-10-31
|33
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Mansion/Estate Horror
|Ghosts
|-

|-
!align=left|{{TDM-FM|51|The Creeps}}
|Mortem Desino
|{{Bloodgate|thecreeps.pk4}}{{Mirrorlink|http://www.gamefront.com/files/20939925/thecreeps.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13176-fan-mission-creeps-the-20111030-by-mortem-desino/}}
|2011-10-30
|61
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Horror
|Ghosts
|-

|-
!align=left|{{TDM-FM|50|House in Blackbog Hollow}}
|Stumpy
|{{Bloodgate|blackbog.pk4}}{{Mirrorlink|http://www.bookofages.co.uk/doom3/mods/blackbog.html}} {{Forumlink|http://forums.thedarkmod.com/topic/13172-fan-mission-house-in-blackbog-hollow-by-stumpy-20111028/}}
|2011-10-28
|12
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Horror
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|49|Let Sleeping Thieves Lie}}
|Sir Taffsalot, Bikerdude
|{{Bloodgate|lstl.pk4}}{{Mirrorlink|http://www.mediafire.com/?zkd1jn4lpwgioh9}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/13153-let-sleeping-thieves-lie-by-sir-taffsalot-bikerdude-20102011/}}
|2011-10-20
|13
|No
|
|Tombs, Catacombs & Crypts
|Undead
|-

|-
!align=left|{{TDM-FM|48|Samhain Night}}
|PranQster
|{{Bloodgate|samhain.pk4}}{{Mirrorlink|http://jdchoate.mcn.org/games/darkmod/samhain.zip}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/13127-fan-mission-samhain-night-on-bone-hill-by-pranqster-20111009/}}
|2011-10-09
|10
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Horror
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|47|A Score to Settle}}
|Springheel
|{{Bloodgate|score_to_settle.pk4}}{{Mirrorlink|http://www.mediafire.com/?f3o7hm4h4ew7o3l}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12894-fan-mission-%2348-a-score-to-settle-by-springheel-20110701/}}
|2011-07-01
|135
|No
|[[Fan_Mission_Series#Corbin series|Corbin]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|46|Siege Shop}} (v3.0 2013/10/10)
|PranQster and Lowenz
|{{Bloodgate|siegeshop.pk4}}{{Mirrorlink|http://jdchoate.mcn.org/games/darkmod/siegeshop.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12874-fan-mission-the-siege-shop-by-pranqster-20110626/}}
|2011-06-26
|20.51
|No
|
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|44|Alberic's Curse}}
|Bikerdude
|{{Bloodgate|alberic.pk4}} {{Mirrorlink|http://www.gamefront.com/files/20459738/alberic.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12850-fan-mission-alberics-curse-by-b1k3rdude-20062011/}}
|2011-06-20
|29
|No
|[[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]] (Winner) T2 FM homage
|Church/Cathedral
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|45|Reap As You Sow}}
|Fieldmedic
|{{Bloodgate|reap.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12849-fan-mission-reap-as-you-sow-by-fieldmedic-20110619/}}
|2011-06-19
|52
|No
|[[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|Outdoor/Daylight Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|43|Rake Off}}
|Jesps
|{{Bloodgate|rake_off.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12846-fm-rake-off-19-06-2011/}}
|2011-06-19
|8
|No
|[[Fan_Mission_Series#Selis Woderose series|Selis Woderose]] [[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|42|Winter Harvest}} (v2.0 2011/07/24 with Bikerdude)
|ShadowHide
|{{Bloodgate|winterharvest.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12690-seasons-contest-entry-winter-harvest-by-shadowhide/}}
|2011-05-08
|10
|No
|[[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|Outdoor/Pagan
|Spiders
|-

|-
!align=left|{{TDM-FM|41|Fiasco at Fauchard Street}}
|Melan
|{{Bloodgate|fauchard.pk4}} {{Mirrorlink|https://rapidshare.com/files/460141132/fauchard.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12655-fan-mission-fiasco-at-fauchard-street-by-melan-20110501//}}
|2011-05-01
|62
|No
|[[Fan_Mission_Series#Sir Talbot series|Sir Talbot]]
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|40|Mandrasola}}
|Sotha
|{{Bloodgate|mandrasola.pk4}} {{Mirrorlink|http://www.mediafire.com/?2ox2nbhh796ne71}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12575-fan-mission-mandrasola-by-sotha-20110410/}}
|2011-04-10
|10
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]] [[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|City Missions
|Undead
|-

|-
!align=left|[http://www.southquarter.com/tdm/fms/yantdm1.1.pk4 Q4 Conversion: Yan's Test]
|Bikerdude
|{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12506-fan-mission-q4-map-conversion-yantdm1-280311/}}
|2011-03-28
|28
|No
|
|
|
|-

|-
!align=left|{{TDM-FM|38|The Transaction}}
|Sotha
|{{Bloodgate|transaction.pk4}} {{Mirrorlink|http://www.mediafire.com/?ux7mx79wumnvcb6}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12408-fan-mission-the-transaction-by-sotha-20110304/}}
|2011-03-04
|10
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|13|Return to the City}} (v3.0 2015/01/03)
|Melan, Bikerdude
|{{Bloodgate|ReturnToTheCityV2.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10509-fan-mission-return-to-the-city-by-melan-20100110/}} {{Forumlink|1=http://www.ttlg.com/forums/showthread.php?t=130519/}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12390-fan-mission-return-to-the-city-v2-01032011/}}
|2010-01-10
|26
|No
|[[Fan_Mission_Series#Sir Talbot series|Sir Talbot]] [[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]] (Winner)
|City Missions
|
|-

|-
!align=left|{{TDM-FM|39|Lockdown}}
|GameDevGoro Bikerdude Fidcal
|{{Bloodgate|lockdown1_2_1.pk4}} {{Mirrorlink|http://www.fidcal.com/darkuser/missions/lockdown1_2_1.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12064-fm-lockdown-part-1-by-gamedevgoro-and-bikerdude-20101224/}}
|2010-12-25
|3
|No
|Lockdown 1
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|37|Flakebridge Monastery}}
|Jesps
|{{Bloodgate|flakebridge.pk4}} {{Mirrorlink|http://www.file-upload.net/download-3024426/flakebridge.pk4.html}} {{Mirrorlink|http://rapidshare.com/files/434997519/flakebridge.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11991-fm-flakebridge-monastery-by-jesps/}}
|2010-12-05
|16
|No
|[[Fan_Mission_Series#Selis Woderose series|Selis Woderose]]
|Church/Cathedral
|Undead
|-

|-
!align=left|{{TDM-FM|36|Knighton Manor, The}}
|Sotha
|{{Bloodgate|knighton_manor.pk4}} {{Mirrorlink|http://www.mediafire.com/?xrdts3j4t2qxre2}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11898-fan-mission-the-knighton-manor-by-sotha-20101109/page__view__getnewpost}}
|2010-11-09
|21
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|35|St Albans Cathedral}} (v2.0 2014/06/11)
|Bikerdude
|{{Bloodgate|stac160.pk4}} [[http://www.bloodgate.com/fms/stac142.pk4 Classic]] {{Mirrorlink|http://www.filefront.com/17464439/stac141.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16343-fan-mission-st-albans-cathedral-v20-11062014/}} {{Loot|FM:TDM_St_Alban's_Cathedral_-_Bikerdude}}
|2010-11-01
|67
|No
|[[Fan_Mission_Series#St Alban series|St Alban]]
|Church/Cathedral
|Undead
|-

|-
!align=left|{{TDM-FM|33|Swing}}
|Komag
|{{Bloodgate|swing_v1.2.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11660-vertigo-contest-entry-swing-by-komag-20100825/}} {{Loot|FM:TDM_Swing_-_Komag}}
|2010-08-25
|3
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Platforming/Jumping Experimental
|
|-

|-
!align=left|{{TDM-FM|32|The Caduceus of St. Alban}} (v.1.5.5 2010/08/26)
|Bikerdude
|{{bloodgate|stalban.pk4}} {{Mirrorlink|http://www.filefront.com/17237609/stalban.pk4/}}{{Forumlink|http://forums.thedarkmod.com/topic/11644-the-caduceus-of-st-alban-vertical-fm-contest-entry-aug-8th-2010/}}
|2010-08-23
|11.3
|No
|[[Fan_Mission_Series#St Alban series|St Alban]] [[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Church/Cathedral
|Spiders
|-

|-
!align=left|{{TDM-FM|30|Somewhere Above the City}} (v1.1 2010/08/27)
|grayman
|{{Bloodgate|somewhere1.1.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11619-vertical-contest-mission-somewhere-above-the-city-by-grayman-aug-20-2010/}} {{Loot|FM:TDM_Somewhere_Above_the_City_-_grayman}}
|2010-08-20
|11
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Tombs, Catacombs & Crypts
|
|-

|-
!align=left|{{TDM-FM|29|Betrayal}} (v.1.1, 2010/09/01)
|Fieldmedic
|{{Bloodgate|betrayal.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11605-betrayal-by-fieldmedic-20100817-summer-fm-vertical-contest-entry/}} {{Loot|FM:TDM_Awaiting_the_Storm_-_HappyCheeze}}
|2010-08-17
|12
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Horror
|Undead
|-

|-
!align=left|{{TDM-FM|31|Rift, The}}
|Baddcog
|{{Bloodgate|rift.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11599-vert-contest-mission-the-rift-by-baddcog-aug-15-2010/}}
|2010-08-15
|10
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Lost Civilizations
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|34|Illusionist's Tower}}
|stumpy
|{{Bloodgate|holetower.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11541-illusionists-tower-by-stumpy-201085-summer-fm-vertical-contest-entry}} {{Forumlink|1=http://www.bookofages.co.uk/doom3/mods/holetower.html}} {{Loot|FM:TDM_Illusionist%27s_Tower_-_stumpy}}
|2010-08-05
|9
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Horror Experimental
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|28|Mad's Mountain}}
|Jesps
|{{Bloodgate|madmountain.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11510-fan-mission-mads-mountain-by-jesps-20100731}} {{Loot|FM:TDM_Lord_Dufford%27s_-_stumpy}}
|2010-07-31
|2
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Outdoor/Caves
|
|-

|-
!align=left|{{TDM-FM|27|Glenham Tower, The}}
|Sotha
|{{Bloodgate|glenham_tower.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11423-fan-mission-the-glenham-tower-by-sotha-20100717}}
|2010-07-17
|5
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]] [[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]] (Winner)
|Castle/Fortress Horror
|Undead
|-

|-
!align=left|{{TDM-FM|25|Pandora's Box}}
|Jesps, Fidcal
|{{Bloodgate|pandoras_box.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11381-fan-mission-pandoras-box-by-jesps20100711}} {{Loot|FM:TDM_Pandora%27s_Box_-_Jesps}}
|2010-07-11
|7
|No
|
|Pirate Ship Experimental
|
|-

|-
!align=left|{{TDM-FM|23|Beleaguered Fence, The}}
|Sotha
|{{Bloodgate|beleaguered_fence.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11298-fan-mission-the-beleaguered-fence-by-sotha-20100623}} {{Loot|FM:TDM_The_Beleaguered_Fence_-_Sotha}}
|2010-06-23
|11
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|22|Special Delivery, A}}
|Silencium18
|{{Bloodgate|delivery.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11247-fan-mission-a-special-delivery-by-silencium1820100612}} {{Loot|FM:TDM_A_Special_Delivery_-_Silencium18}}
|2010-06-12
|2
|No
|
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|21|Alchemist, The}} (2010/06/04)
|Sotha, Fidcal
|{{Bloodgate|alchemist.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11170-fan-mission-the-alchemist-by-sotha-fidcal20100601}} {{Loot|FM:TDM_The_Alchemist_-_Sotha_%26_Fidcal}}
|2010-06-01
|27
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|20|Awaiting The Storm}}
|HappyCheeze
|{{Bloodgate|storm.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11095-fm-awaiting-the-storm-by-happycheeze-20200522}} {{Loot|FM:TDM_Awaiting_the_Storm_-_HappyCheeze}}
|2010-05-22
|4
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|19|Sound Alert & Blackjack Trainer}}
|Dark Mod Team
|
|2010-05-14
|0.2
|No
|
|Training
|
|-

|-
!align=left|{{TDM-FM|18|No Honor Among Thieves}} (v.3.0, 2015/05/30)
|Goldchocobo, RailGun, Mortem Desino, Bikerdude
|{{Mirrorlink|http://tinyurl.com/2a9mdcs}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10993-fan-mission-no-honor-among-thieves-20100429}} {{Loot|FM:TDM_No_Honor_Among_Thieves_-_Goldchocobo}}
|2010-04-29
|203
|No
|
|Church/Cathedral; City Missions; Outdoor/Pagan, Mansion/Estate
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|17|Heart of Lone Salvation, The}} (v.2.0, 2014/04/12)
|Fidcal, Baddcog, Bikerdude
|{{Bloodgate|heart.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/topic/10878-fan-mission-the-heart-of-lone-salvation-by-fidcal-baddcog-bikerdude-20100402/?p=213506}} {{Walkthrough|FM:TDM_The_Heart_of_Lone_Salvation_-_Fidcal_%26_Baddcog_%26_Bikerdude}} {{loot|FM:TDM_The_Heart_of_Lone_Salvation_-_Fidcal_%26_Baddcog_%26_Bikerdude}}
|2010-04-02
|41
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|City Missions
|Spiders
|-

|-
!align=left|{{TDM-FM|73|Lord Dufford's}}
|stumpy
|{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10868-fan-mission-lord-duffords-20100331}} {{Loot|FM:TDM_Lord_Dufford%27s_-_stumpy}}
|2010-03-31
|22
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|16|Builder's Influence, The}} (2010/03/23)
|Railgun, Springheel
|{{Bloodgate|builders_influence.pk4}} {{Mirrorlink|http://www.fidcal.com/darkuser/missions/builders_influence.pk4}}{{Forumlink|http://forums.thedarkmod.com/index.php?/topic/10811-fan-mission-the-builders-influence-20100320/}} {{Loot|FM:TDM_The_Builders_Influence_-_Railgun%26Springheel}}
|2010-03-20
|15
|No
|[[Fan_Mission_Series#Corbin series|Corbin]]
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|14|Business as Usual}} (v2.0 2011/09/24)
|Bikerdude
|{{Bloodgate|business.pk4}}{{Mirrorlink|1=http://rapidshare.com/files/335299431/business.pk4.html}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10533-fan-mission-business-as-usual-by-b1k3rdude-14012010-christmas-fm-contest-entry/page__view__findpost__p__207055}}
|2010-01-14
|4
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Sewers
|
|-

|-
!align=left|{{TDM-FM|12|Sons of Baltona 1, The}}
|Carnage
|{{Bloodgate|sons_of_baltona_1.pk4}} {{Mirrorlink|1=http://www.mediafire.com/?m4ywobjodm0}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10498-fan-mission-the-sons-of-baltona-1-by-carnage-20100109}}
|2010-01-09
|3
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]] / Baltona 1
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|11|Living Expenses}}
|Sonosuke
|{{Bloodgate|living_expenses.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10451-fm-living-expenses-by-sonosuke-2-jan-10/page__view__findpost__p__205386}}
|2010-01-02
|6
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|10|Trapped!}}
|RailGun
|{{Bloodgate|trapped.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10442-fm-trapped-by-railgun-dec-30/page__view__findpost__p__205092}}
|2009-12-30
|6
|No
|
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|8|Parcel, The}}
|Xonze
|{{Bloodgate|parcel.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10404-fm-the-parcel-by-xonze-dec-24/page__view__findpost__p__204459}}
|2009-12-24
|7
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|9|Too Late}}
|Nielsen74
|{{Bloodgate|too_late.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10400-fm-too-late-by-nielsen74-24-dec-09/page__view__findpost__p__204396}}
|2009-12-24
|4
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|7|Thieves}}
|Silencium, RailGun, Fidcal
|{{Bloodgate|thieves.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10286-fm-the-thieves-nov-2509/}}
|2009-11-26
|9
|No [https://www.moddb.com/mods/the-dark-mod/addons/unofficial-thieves-efx Unofficial EFX Build]
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|6|Patently Dangerous}} (v.2.0, 2013/10/08)
|demagogue
|{{Bloodgate|patently_dangerous.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10125-fm-patently-dangerous-oct3109/page__view__findpost__p__199324/}}
|2009-10-31
|24
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|5|Dark Mod Training Mission, The}}
|TDM Team
|{{Bloodgate|training_mission.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9932-fm-training-mission-17-oct-09/}}
|2009-10-17
|6
|No
|[[Fan_Mission_Series#Introduction_campaign|Official Campaign]]
|Training Platforming/Jumping
|
|-

|-
!align=left|{{TDM-FM|2|Crown of Penitence, The}}
|Jesps
|{{Bloodgate|crow_of_penitence.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9934-fm-crown-of-penitence-by-jesps-17-oct-09/}}
|2009-10-16
|12
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|3|Chalice of Kings, The}} (v.2.0, 2015/09/24) (Bikerdude and Xarg)
|Fidcal
|{{Bloodgate|chalice.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9935-fm-chalice-of-kings-by-fidcal-17-oct-09/}} {{Loot|FM:TDM_Chalice_of_Kings_-_Fidcal}}
|2009-10-15
|3
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|1|Outpost, The}}
|angua, greebo
|{{Bloodgate|outpost.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9937-fm-the-outpost-by-angua-greebo-17-oct-09/}}
|2008-12-23
|2
|No
|
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|15|Mission 2: Tears of Saint Lucia, The}} (v.3.0, 2017/02/14)
|TDM Team
|{{Bloodgate|saintlucia.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10579-fan-mission-the-tears-of-st-lucia-20081021/page__view__findpost__p__207972}} {{Loot|FM:TDM_The_Tears_of_Saint_Lucia_-_jdude}} [https://www.youtube.com/watch?v=yrGxoi3LSGg Briefing]
|2008-10-21
|20.3
|No
|[[Fan_Mission_Series#Introduction_campaign|Official Campaign]]
|Church/Cathedral
|Spiders
|-

|-
!align=left|{{TDM-FM|57|Closemouthed Shadows}} (v.2.0, 2012/01/15)
|LordSavage, Bikerdude
|{{Bloodgate|closemouthed_shadows.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/topic/13383-fan-mission-closemouthed-shadows-2008-reworked-for-tdm-107-20120115/}}
|2008-09-21
|2
|No
|Closemouthed Shadows 1
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|24|Thief's Den}} (v.2.0, 2010/07/04)
|Fidcal, greebo
|{{Bloodgate|thiefs_den.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11347-fan-mission-thiefs-den-re-release-by-fidcal20100704}} {{Walkthrough|FM:TDM_Thief's_Den_-_Fidcal}} {{Loot|FM:TDM_Thief%27s_Den_-_Fidcal}}
|2008-01-18
|3
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|City Missions
|
|}

To see a speculative list of Upcoming Fan Missions, please visit: [[Upcoming Fan Missions]]

== Table notes ==

'''Links Key'''
{|class="wikitable" border=1 style="border-collapse: collapse;" cellspacing=0 cellpadding=2
|-
|[http://wik.thedarkmod.com/images/b/be/Icon_forum.png http://wiki.thedarkmod.com/images/b/be/Icon_forum.png]
|Link to discussion in Forums
|-
|{{Mirrorlink|}}
|Misc. download mirror
|-
|{{Bloodgate|}}
|Bloodgate download mirror
|-
|{{Loot|}}
|Loot list
|-
|{{Walkthrough|}}
|Walkthrough
|}

----

'''Mission Type Key'''

''Bear in mind that individual FMs can have combinations of two or three of these overarching genres/themes, rather than just a single one.''

{|class="wikitable" border=1 style="border-collapse: collapse;" cellspacing=0 cellpadding=2
|-
|'''''Bank Jobs'''''
|Fan mission involving a heist or other thievy action inside a local banking institution. Will often contain the outsmarting of security systems, gaining access to a safe and cracking its code.
|-
|'''''Castle/Fortress'''''
|Fan mission involving a heist or other thievy action inside or outside a castle or fortress, either one that serves as a military garrison, or as someone's private residence. Frequently involves background characters from the nobility.
|-
|'''''City Missions'''''
|Fan mission that is set mainly in the streets and public spaces of an urban area, such as a town or city. Though the player is most often out on the streets, these missions tend to also involve some degree of exploration and infiltration into private and public buildings alike.
|-
|'''''Church/Cathedral'''''
|Fan mission set in and around religious buildings and institutions, such as churches, monasteries, cathedrals, church bureaus, church workshops, etc. Frequently involves [[Clergy/Builder_Characters|ecclesiastical characters]] from the TDM setting's [[Builders|Builder Church]].
|-
|'''''Experimental'''''
|Fan mission which involves some creative design or gameplay element that isn't typical for the vast majority of TDM missions. FMs set in highly unusual environments, or with a puzzle-like nature, can fit under this label.
|-
|'''''Inn/Tavern'''''
|Fan mission set mostly in and around an inn, tavern or shanty. Usually focused on robbing some rich guest, acquiring an item stored by the guest at the inn, or gathering intel at the inn.
|-
|'''''Jail/Prison'''''
|Fan mission involving an escape from a prison (by the imprisoned player character), infiltration of a prison to gather intel from inmates or help an inmate escape the prison, etc.
|-
|'''''Lost Civilizations'''''
|Fan mission focused on the exploration of ancient ruins, whether above ground or in deep subterranean caverns. Can often overlap with the ''Horror'' or ''Tombs, Catacombs & Crypts'' type of mission, but not necessarily.
|-
|'''''Horror'''''
|Fan mission with an overt horror theme. Depending on the author's approach and intentions, it can focus on psychological horror, or horror based on danger from supernatural threats, or varying combinations of both.
|-
|'''''Mansion/Estate'''''
|Fan mission involving a heist or other thievy action inside someone's private residence (a fancy house, a manor house) and its surrounding grounds. Frequently involves background characters from the nobility or the more affluent townsmen or citizens.
|-
|'''''Museum Heists'''''
|Fan mission focusing on a heist in a museum, art gallery or other institution storing priceless artefacts, artworks, gemstone collections, etc.
|-
|'''''Outdoor/Caves'''''
|Fan mission set in a mostly natural outdoor environment, but involving the exploration of natural caves and caverns.
|-
|'''''Outdoor/Daylight'''''
|Fan mission set in a mostly outdoor environment, during the daytime (in contrast to the usual TDM missions, set at night time or early dusk).
|-
|'''''Outdoor/Pagan'''''
|Fan mission set in a mostly natural outdoor environment, involving some presence of [[Pagans|pagan tribes]] from TDM's setting. Perhaps even pagan camps and settlements.
|-
|'''''Pirate'''''
|Fan mission involving the presence of characters engaging in piracy or smuggling, and various related piratical themes. Can overlap with the ''Ship'' type of mission, but not necessarily.
|-
|'''''Platforming/Jumping'''''
|Fan mission focusing on testing the player's movement, jumping and climbing skills, with or without equipment.
|-
|'''''Sewers'''''
|Fan mission which involves the use of the city sewers or others sewers in some way, often as a stealthy means of entry or escape.
|-
|'''''Ship'''''
|Fan mission which takes place aboard a vessel, in port or at sea, or otherwise involves ships to a great degree. Can overlap with the ''Pirate'' type of mission, but not necessarily.
|-
|'''''Thieves' Highway / Rooftop'''''
|Fan mission involving a lot of movement and travel on the rooftops of a town or city (colloquially "The Thieves' Highway").
|-
|'''''Tombs, Catacombs & Crypts'''''
|Fan mission involving the exploration of old tombs, catacombs and crypts, often for the purposes of treasure and artefact hunting. Can often overlap with the ''Horror'' or ''Lost Civilizations'' type of mission, but not necessarily.
|-
|'''''Training'''''
|Fan mission label that is unique to the official Training Mission, an open-ended tutorial mission where players can practice and test their TDM gameplay skills at their own leisure, and to the smaller blackjacking-trainer FM, which focuses on practicing NPC knockouts by the player.
|-
|'''''Warehouse'''''
|Fan mission which takes place in and around a warehouse, usually in some industrial area of a city, or at a port.
|}

----

'''Contest Key'''

GCC 09: [[Fan_Mission_Contests#2009 Grand Christmas Contest|Grand Christmas Contest 2009]]

SVC 10: [[Fan_Mission_Contests#2010 Summer Vertical Contest|Summer Vertical Contest 2010]]

CSC 11: [[Fan_Mission_Contests#2011 Community Seasons Contest|Community Seasons Contest 2011]]

HSC 11: [[Fan_Mission_Contests#2011 Halloween Speed-build Contest|Halloween Speed-Build Contest 2011]]

CBC 12: [[Fan_Mission_Contests#2012 Community Beginner Contest|Community Beginner Contest 2012]]

CUC 13: [[Fan_Mission_Contests#2013 Community Unusual Contest|Community Unusual Contest 2013]]

HSC 14: [[Fan_Mission_Contests#2014 Halloween Speed-build Contest|Halloween Speed-Build Contest 2014]]

HSC 15: [[Fan_Mission_Contests#2015 Halloween Speed-build Contest|Halloween Speed-Build Contest 2015]]

----

== Editing this table ==
* Please only include playable missions that are fully released, not those currently in development or testing. Tutorials, demos, prefabs, etc. should be listed elsewhere.
* A mission title may be listed in plain text as a record of release, or preferably a link to an information page or primary direct download.
* List by release date descending (newest at the top).
* If a fan mission only has a single mirror/host please consider adding additional mirrors.

== See also ==
* [[Fan Mission Series]] - An overview of all currently known series or campaigns of fan missions interconnected by their stories or characters. There are already plenty in TDM, and have been since its early days as an expandable game.
* [[Mission recommendation discussions]] - An overview of past discussions on what FMs the community recommends to players looking for various challenges (difficulty, size, theme, setting, objectives, etc.).
* [[Fan Mission Contests]] - An overview of past and present contests in Fan Mission creation, by members of the TDM community.
* [[Upcoming Fan Missions]] - An overview of Fan Missions in development or tentatively planned. (''Do not'' edit the overview.)

{{general|sort=Fan Missions}}
[[Category:Fan Missions]]
[[Category:Official FMs| ]]

User:VanishedOne

2019-09-10T17:02:03Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Emitted to what?

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] so maybe it survived in Prey?)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky. Unused? draw_common.cpp:

if ( shader->IsPortalSky() ) { // NB TDM portal sky does not use this flag or whatever mechanism
return; // it used to support. Our portalSky is drawn in this procedure using
}

// the skybox image captured in _currentRender. -- SteveL working on #4182

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

Script objects

2019-09-09T17:04:09Z

VanishedOne: /* tdm_light_holder */ From what I can see, only STIM_TRIGGER is actually processed by tdm_light_holder

== Introduction ==

A '''script object''' is an object that is written in the idTech4 scripting language, and an be attached to arbitrary entities. Each entity can have '''only one''' script object, but one script object can be attached to multiple entities.

To use a script object on an entity, give it the spawnarg '''scriptobject''' set to the name of the script object. For your convience, TDM already contains a few useful script objects, here is a list:

== List of script objects ==

=== tdm_alarm ===

A script object that sounds an alarm sound that can be heard by AI as suspicious sound, as well as a player audible sound.

Functions:

void start_alarm();
void stop_alarm();

See [[atdm:alarm_sound]] on how to use it.

=== tdm_suicide ===

<pre>
"scriptobject" "tdm_suicide"
"remove_delay" "100" // remove this entity 100 seconds after spawning it
</pre>

Note: In TDM v1.03 the delay '''must be''' >= 1, or the script will wait 360 seconds. In TDM v1.04, the time can also be between 0 and 1 second, for instance 0.5 seconds.

Note #3: From TDM v1.04 onwards, any entity with this script object will activate its targets right before it removes itself. This can be used to trigger things after a certain time from map start has passed, and is used f.i. by the new "atdm:vanishing_platform" entity.

=== tdm_light_holder ===

<pre>
"scriptobject" "tdm_light_holder"
"extinguished" "1" // the light starts off, but can be lit by the player
</pre>

This is typical attached to either lights (an electrical lamp f.i.) or light holders (a candle holder with attached candle + flame, or a torch with attached flame). This script object has handy methods to toggle all lights that this holder has, regardless how many (multiple flames?) or where (flame on holder or flame on candle on holder?).

This script object also makes the entity react to triggers like when you link a button/lever/trigger to this entity.

(See also the light_ext and light_moving_ext scriptobjects, used by extinguishable light sources to respond to fire/water/gas stims.)

=== tdm_gui_message ===

This script object is attached to an '''atdm:gui_message''' entity, and the entity shows a message to the player, based on cvars and spawnargs. You can use this script object for the "popup" messages that appear on the upper left corner (f.i. to give the player hints) or for screeen overlays like in a movie, where it says f.i. "Random Town, past midnight". Where the message appears and how it looks is entirely customizable by using a different gui.

See [[Popup messages]] for more information.

==== CVARs ====

* '''tdm_show_trainer_messages''' - if true, trainer messages are shown, if false, suppressed

==== Spawnargs ====

* '''show'''- The time in seconds the message is shown, will be longer by approx. one second to fade the message out. If set to 0, shows the message for 6 seconds plus 1s fade out.
* '''lines''' - Number of lines the text has
* '''text''' - The text to be shown on the message.
* '''gui''' - Name of the GUI file, defaults to ''guis/tdm_message.gui''
* '''wait''', '''delay''' - These two are inherited from '''atdm:target_callobjectfunction''' and set the "wait" between triggers and the initial "delay" before the messsage show.
* '''fade_out_time''' - Defaults to 1, in seconds. This time is waited for the GUI to fade out, then the message is forcefully removed. If you use a different gui with "gui", then set this spawnarg to match the fadeout time of your gui.
* '''auto_trigger''' - Boolean, if true, the msg is triggered "delay" seconds after map load automatically.
* '''force''' - Boolean, if true, the msg is always shown, regardless of the menu setting (e.g. the CVAR).

==== Notes ====

# Currently messages just overlay each other on the screen. So if a later messages is displayed while an old message is still there, they fade over from the old one to the new one.
# If the player then steps back into the first trigger, the old message is not displayed again, because it is still waiting around.

=== tdm_voice ===

A script object for atdm:voice, which can play voices (or any other sounds) so they appear to come from the player. Can be used for voiceovers and narrator effects. These effects use separate volumes defined by two different CVARs.

How to use:

# Place an '''atdm:voice''' entity (in '''Sound''' folder) in your map (location does not matter, and you need only one)
# Place multiple '''atdm:voice_trigger''' entities (in '''Targets''' folder) in your map
# Link your '''atdm:voice_trigger''' entities to your '''atdm:voice''' entity ({{key|CTRL}}+{{key|K}} in [[DarkRadiant]])

Give the following spawnargs to the '''atdm:voice_trigger''' entities:

<pre>
"snd_say" "sound_you_want_to_play" // generic, male or female
"as_player" "1" // if the player should say things
"as_player" "0" // if the narrator should say things
</pre>

When "as_player" is set to "1", the sound volume is controlled by the "Player Voice Volume" slider in the TDM Audio menu.

When "as_player" is set to "0", the sound volume is controlled by the "Narrator Volume" slider in the TDM Audio menu.
==== CVARS ====

* tdm_voice_player_volume // Player Voice Volume
* tdm_voice_from_off_volume // Narrator Volume
* Menu settings

'''Unsupported''' options (taken out because the team doesn't want to add them):

* CVAR: tdm_player_is_female
* Spawnarg: "snd_say_female" "female_sound_you_want_to_play" // overrides snd_say if the player is female

== See also ==

* [[Writing script objects]]

{{scripting}}

Fan Missions for The Dark Mod

2019-09-03T18:29:38Z

VanishedOne: I don't remember warehouse.map in mercwarehouse.pk4 as a city mission either.

__NOTOC__
{{infobox|<center>'''Big Ugly Disclaimer:'''</center> '''The Dark Mod''' team does not necessarily support or endorse content listed here, and only hosts missions listed on the [http://www.thedarkmod.com/ official TDM website]. This is a community maintained list, and an ongoing work in progress. Most of the mirror links in this list are dead or are for missions that are not 2.0 compliant. Mission entries which are suspected to violate copyright must be text-only, and cannot contain links. Report and/or remove links found in violation of this rule.}}

* For details about editing this table, see [[#Editing_this_table|below]].
* For details about how to install Fan Missions please visit: [[Installing and Running Fan Missions]]
* To sort by a different criterion, click the [[Image:Sort none.gif]] icon in the relevant column header.

{|class="wikitable sortable" border=1 style="border-collapse: collapse;" cellspacing=0 cellpadding=2 width=100%
|-
!bgcolor=#d0d0e0 width="21%"|Fan Mission Title
!bgcolor=#d0d0e0 width="11%"|Author(s)
!bgcolor=#d0d0e0 width="4%" class="unsortable"|Links
!bgcolor=#d0d0e0 width="5%"|First Release
!bgcolor=#d0d0e0 width="2%"|Size (MB)
!bgcolor=#d0d0e0 width="3%"|EFX Reverb
!bgcolor=#d0d0e0 width="10%"|Series
!bgcolor=#d0d0e0 width="13%"|Mission Type
!bgcolor=#d0d0e0 width="6%"|Spiders and Undead
|-



|-
!align=left|{{TDM-FM|138|Hidden Hands: Vitalic Fever}}
|JackFarmer
|{{Forumlink|http://forums.thedarkmod.com/index.php?/topic/20051-hidden-hands-vitalic-fever-20072019}}
|2019-07-20
|269
|Yes
|Hidden Hands 2
|Mansion/Estate
|Spiders, undead
|-

|-
!align=left|{{TDM-FM|137|Chronicles of Skulduggery 2: Pearls and Swine}}
|Bienie
|{{Forumlink|http://forums.thedarkmod.com/topic/19975-fan-mission-chronicles-of-skulduggery-2-a-precarious-position-20190504/}}
|2019-05-04
|14.5
|Yes
|[[Fan_Mission_Series#Chronicles_of_Skulduggery_series|Chronicles of Skulduggery]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|136|William Steele 5: Commerce Bank}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19957-fan-mission-commerce-bank-by-grayman-2019410/}}
|2019-04-10
|30
|Yes
|[[Fan_Mission_Series#William_Steele_series|William Steele]]
|Bank Jobs
|
|-

|-
!align=left|{{TDM-FM|135|Marsh of Rahena}}
|ERH+
|{{Forumlink|http://forums.thedarkmod.com/topic/19951-fan-mission-marsh-of-rahena-by-erh-201945}}
|2019-04-05
|60.3
|Yes
|
|Castle/Fortress, Horror
|Undead, Spiders, Horror Themes
|-

|-
!align=left|{{TDM-FM|134|Shadows of Northdale ACT 2}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/19936-fan-mission-shadows-of-northdale-act-ii-by-goldwell-20190320/}} [https://www.youtube.com/watch?v=KO-eIOX9nqI Briefing]
|2019-03-20
|417
|Yes
|[[Fan_Mission_Series#Shadows of Northdale series|Shadows of Northdale]]
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|133|Cleaning Up the Neighbourhood}}
|some1stoleit and Bikerdude
|{{Forumlink|http://forums.thedarkmod.com/topic/19898-fan-mission-cleaning-up-the-neighbourhood-by-some1stoleitbikerdude-20190219/}}
|2019-02-18
|34.3
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|132|Hidden Hands: Initiation}}
|JackFarmer
|{{Forumlink|http://forums.thedarkmod.com/topic/19796-hidden-hands-initiation-27122018/}}
|2018-12-27
|92.5
|Yes
|
|Mansion/Estate Ship
|Spiders, Extra-natural entities
|-

|-
!align=left|{{TDM-FM|131|The Night of Reluctant Benefaction}}
|Bienie
|{{Forumlink|http://forums.thedarkmod.com/topic/19787-fan-mission-the-night-of-reluctant-benefaction/}}
|2018-12-24
|11.9
|Yes
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|130|Mission of Mercy}}
|joebarnin
|{{Forumlink|http://forums.thedarkmod.com/topic/19642-fan-mission-mission-of-mercy-by-joebarnin-20180914/}}
|2018-09-14
|10.1
|No
|
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|129|William Steele 4: The Warrens}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19618-fan-mission-the-warrens-by-grayman-201891/}}
|2018-09-01
|53
|Yes
|[[Fan_Mission_Series#William_Steele_series|William Steele]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|128|Braeden Church}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19533-fan-mission-braeden-church-by-grayman-201871/}}
|2018-07-01
|24
|No
|
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|127|Chronicles of Skulduggery: Pearls and Swine}}
|Bienie
|{{Forumlink|http://forums.thedarkmod.com/topic/19439-chronicles-of-skulduggery-pearls-and-swine/}}
|2018-05-25
|23
|Yes
|[[Fan_Mission_Series#Chronicles_of_Skulduggery_series|Chronicles of Skulduggery]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|126|Shadows of Northdale ACT I}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/19368-fan-mission-shadows-of-northdale-act-i-by-goldwell-20180323/}} [https://www.youtube.com/watch?v=p4nP3lYd6wg Briefing]
|2018-03-23
|295
|Custom (not EFX)
|[[Fan_Mission_Series#Shadows of Northdale series|Shadows of Northdale]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|125|Sir Taffsalot's Sword}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19361-fan-mission-sir-taffsalots-sword-by-grayman-2018318/}}
|2018-03-17
|11.3
|No
|
|Mansion/Estate In memoriam of Gary (Sir Taffsalot) {{Forumlink|http://forums.thedarkmod.com/topic/19306-sad-news-we-lost-one-of-our-own-sir-taffsalot/}}
|
|-

|-
!align=left|{{TDM-FM|124|The Arena}}
|ERH+
|{{Forumlink|http://forums.thedarkmod.com/topic/19350-fan-mission-the-arena-by-erh/}}
|2018-03-12
|3
|No
|
|Arena Deathmatch Experimental
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|123|The Elixir}}
|Bikerdude and Obsttorte
|{{Forumlink|http://forums.thedarkmod.com/topic/19323-fan-mission-the-elixir-by-b1k3rdude-obsttorte-17022018/}} [https://www.youtube.com/watch?v=KfElYZs-FaE Briefing]
|2018-02-17
|112
|Yes
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|122|Volta 2: Cauldron of the Gods}}
|Kingsal
|{{Forumlink|http://forums.thedarkmod.com/topic/19207-volta-ii-cauldron-of-the-gods/}} [https://www.youtube.com/watch?v=SRRCRVFHruc Briefing]
|2017-11-30
|252
|Yes
|[[Fan_Mission_Series#Volta series|Volta]]
|Lost Civilizations
|Undead
|-

|-
!align=left|{{TDM-FM|121|In the Black}}
|VanishedOne
|{{Forumlink|http://forums.thedarkmod.com/topic/19185-fan-mission-in-the-black/}}
|2017-11-18
|103
|No
|
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|120|Accountant 1: Thieves and Heirs}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/19164-fan-mission-the-accountant-1-thieves-and-heirs-by-goldwell-20171108}} [https://www.youtube.com/watch?v=Tk9DtOT4kjc Briefing]
|2017-11-08
|247
|No
|[[Fan_Mission_Series#The Accountant series|The Accountant]]
|Mansion/Estate
|Spiders
|-

|-
!align=left|{{TDM-FM|119|King of the Mountain}}
|Spoonman
|{{Forumlink|http://forums.thedarkmod.com/topic/19105-fan-mission-king-of-the-mountain-by-spoonman-18092017/}}
|2017-09-18
|8.07
|No
|
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|118|Briarwood Manor}}
|NeonStyle
|{{Forumlink|http://forums.thedarkmod.com/topic/18980-fan-mission-briarwood-manor-by-neonsstyle-first-mission-2017-07-11}} [https://www.youtube.com/watch?v=BZnSuLVatYM Trailer] [https://www.youtube.com/watch?v=CPlu8fEzyGM Briefing]
|2017-07-11
|90
|No
|
|Mansion/Estate
|Spider
|-

|-
!align=left|{{TDM-FM|117|A Matter of Hours}}
|Springheel
|{{Forumlink|http://forums.thedarkmod.com/topic/18809-fan-mission-a-matter-of-hours-by-springheel-2842017/}}
|2017-04-28
|13
|No
|[[Fan Mission Series#Corbin series|Corbin]]
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|116|The Ravine}}
|Spoonman
|{{Forumlink|http://forums.thedarkmod.com/topic/18782-fan-mission-the-ravine-by-spoonman-17042017/}}
|2017-04-17
|30.6
|No
|
|Outdoor/Pagan
|Spiders
|-

|-
!align=left|{{TDM-FM|115|The Bakery Job}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/18707-fan-mission-the-bakery-job-by-sotha-20170309/}}
|2017-03-09
|2
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM||Mission 1: A New Job}}
|Springheel
|{{Forumlink|http://forums.thedarkmod.com/topic/18647-tdm-205-official-introductory-missions/}}
|2017-03-14
|13.8
|No
|[[Fan_Mission_Series#Introduction_campaign|Official Campaign]]
|City Missions Inn/Tavern
|
|-

|-
!align=left|{{TDM-FM|114|Coercion}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/18405-fan-mission-coercion-by-sotha-20160927}}
|2016-09-27
|10
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|113|Down by the Riverside}}
|Dragofer
|{{Forumlink|http://forums.thedarkmod.com/topic/18402-fan-mission-down-by-the-riverside-by-dragofer-20160925}}
|2016-09-25
|56
|No
|[[Fan_Mission_Series#Of Brambles and Thorns series|Of Brambles and Thorns]]
|Mansion/Estate Ship Horror
|Horror themes, Undead
|-

|-
!align=left|{{TDM-FM|112|Penny Dreadful 3: Erasing the Trail}}
|Melan and Bikerdude
|{{Forumlink|http://forums.thedarkmod.com/topic/18200-fan-mission-penny-dreadful-3-by-melan-and-bikerdude-20160710}}
|2016-07-09
|200
|No
|[[Fan_Mission_Series#Penny Dreadful series|Penny Dreadful]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|111|Volta 1: Volta and the Stone}}
|Kingsal
|{{Forumlink|http://forums.thedarkmod.com/topic/18087-fan-mission-volta-and-the-stone-by-kingsal-05262016}}
|2016-05-27
|102
|Yes
|[[Fan_Mission_Series#Volta series|Volta]]
|Mansion/Estate City Missions
|
|-

|-
!align=left|{{TDM-FM|110|Full Moon Fever}} (v2.0 2018/02/21)
|Spoonman
|{{Forumlink|http://forums.thedarkmod.com/topic/18066-fan-mission-full-moon-fever-by-spoonman-14052016/}}
|2016-05-14
|21
|No
|
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|109|King of Diamonds}}
|Spooks
|{{Forumlink|http://forums.thedarkmod.com/topic/18064-fan-mission-the-king-of-diamonds-by-spooks-20160513}}
|2016-05-13
|26
|No
|
|City Missions
|Occult themes
|-

|-
!align=left|{{TDM-FM|108|Accountant 2: New in Town}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/18054-fan-mission-the-accountant-2-new-in-town-by-goldwell-20160509/}} [https://www.youtube.com/watch?v=xeuIO_GcYjQ Briefing] [https://www.youtube.com/watch?v=w6e_SJ0_JOM Gameplay trailer]
|2016-05-08
|358
|No
|[[Fan_Mission_Series#The Accountant series|The Accountant]]
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|107|The Smiling Cutpurse}}
|Airship Ballet
|{{Forumlink|http://forums.thedarkmod.com/topic/17850-fan-mission-the-smiling-cutpurse-by-airship-ballet-20160325/}}
|2016-03-25
|87
|No
|
|Mansion/Estate Sewers
|
|-

|-
!align=left|{{TDM-FM|106|Mother Rose}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/17653-fan-mission-mother-rose-by-grayman-20160101/#entry385131/}}
|2016-01-01
|10
|No
|
|Mansion/Estate
|Ghost
|-

|-
!align=left|{{TDM-FM|105|Behind Closed Doors}}
|Bikerdude and the Crucible Team
|{{Forumlink|http://forums.thedarkmod.com/topic/17627-crucible-of-omens-behind-closed-doors-by-bikerdude-the-crucible-team-updated-18122015/}}
|2015-12-19
|359
|Yes
|[[Fan_Mission_Series#Crucible of Omens series|Crucible of Omens]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|103|The Rats Triumphant}}
|Melan
|{{Forumlink|http://forums.thedarkmod.com/topic/17512-fan-mission-the-rats-triumphant-by-melan-20151031/}}
|2015-10-31
|11
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]] (Winner)
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|104|Dead Drunk}}
|Stumpy
|{{Forumlink|http://forums.thedarkmod.com/topic/17511-fan-mission-dead-drunk-by-stumpy-20151030/}}
|2015-10-30
|4
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Tombs, Catacombs & Crypts
|Undead
|-

|-
!align=left|{{TDM-FM|97|Thief's Remorse}}
|Airship Ballet
|{{Forumlink|http://forums.thedarkmod.com/topic/17509-fan-mission-thiefs-remorse-by-airship-ballet-20151030/}}
|2015-10-30
|42
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Tombs, Catacombs & Crypts
|Undead
|-

|-
!align=left|{{TDM-FM|102|Spring Cleaning}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/17510-fan-mission-spring-cleaning-by-goldwell-20151030/}} [https://www.youtube.com/watch?v=JzPpmDK9Fxw Briefing]
|2015-10-30
|45
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Mansion/Estate
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|96|The Golden Skull}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/17497-fan-mission-the-golden-skull-by-sotha-20151024/}}
|2015-10-25
|7
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|101|A House of Locked Secrets}}
|Moonbo
|{{Forumlink|http://forums.thedarkmod.com/topic/17163-fan-mission-a-house-of-locked-secrets-by-gelo-moonbo-fleisher-20150528/}} [https://www.youtube.com/watch?v=f5NuTJEZ8VE Trailer]
|2015-05-29
|195
|No
|[[Fan_Mission_Series#Shadowcursed series|Shadowcursed]]
|Church/Cathedral Mansion/Estate
|Horror themes Undead
|-

|-
!align=left|{{TDM-FM|100|Ulysses 2: Protecting the Flock}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/17162-fan-mission-ulysses-2-protecting-the-flock-by-sotha-20150528/}}
|2015-05-28
|102
|No
|[[Fan_Mission_Series#Ulysses series|Ulysses]]
|Church/Cathedral
|
|-

|-
!align=left|{{TDM-FM|99|Sir Talbot's Collateral}}
|Baal and Bikerdude
|{{Forumlink|http://forums.thedarkmod.com/topic/17093-fan-mission-sir-talbots-collateral-by-baal-bikerdude-15042015/}} [https://www.youtube.com/watch?v=e3rdZfq4Omc Trailer]
|2015-04-15
|60
|Yes
|[[Fan_Mission_Series#Sir Talbot series|Sir Talbot]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|98|Vengeance for a Thief Part 3}}
|Sir Taffsalot
|{{Forumlink|http://forums.thedarkmod.com/topic/16953-the-complete-vengeance-for-a-thief-campaign/}}
|2015-02-16
|25
|No
|[[Fan_Mission_Series#Vengeance for a Thief series|VFAT]]
|Church/Cathedral
|
|-

|-
!align=left|{{TDM-FM|95|Lord Edgar's Bathhouse}}
|Goldwell
|{{Forumlink|1=http://forums.thedarkmod.com/topic/16828-fan-mission-lord-edgars-bathhouse-by-goldwell-27122014/}} [https://www.youtube.com/watch?v=vYSZY7VzFEo Briefing]
|2014-12-27
|71
|No
|Lord Edgar
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|94|Quinn Co.}} (Made into a campaign, 2015/02/04)
|Airship Ballet
|{{Forumlink|1=http://forums.thedarkmod.com/topic/16912-fan-mission-chase-mercantile-by-airship-ballet-20150204/}}
|2014-11-22
|111
|No
|Quinn Co.
|Bank Jobs
|
|-

|-
!align=left|{{TDM-FM|93|Exhumed}}
|Airship Ballet and Kyyrma
|{{Forumlink|1=http://forums.thedarkmod.com/topic/16658-fan-mission-exhumed-by-kyyrma-and-airship-ballet-20141104/}}
|2014-11-04
|24
|No
|[[Fan_Mission_Contests#2014 Halloween Speed-build Contest|HSC 14]]
|Church/Cathedral Horror
|Undead
|-

|-
!align=left|{{TDM-FM|92|Briarwood Cathedral}}
|buck28
|{{Mirrorlink|http://www64.zippyshare.com/v/25705489/file.html}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16644-briarwood-cathedral/}}
|2014-10-29
|7
|No
|[[Fan_Mission_Series#Master thief Corso series|Corso]] [[Fan_Mission_Contests#2014 Halloween Speed-build Contest|HSC 14]]
|Church/Cathedral Horror
|Undead
|-

|-
!align=left|{{TDM-FM|91|One Step Too Far}}
|Dragofer
|{{Mirrorlink|https://www.dropbox.com/s/sfxcap1gfdzf318/onesteptoofar.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16457-fan-mission-one-step-too-far-by-dragofer-20140804/}}
|2014-08-04
|9
|No
|[[Fan_Mission_Series#Of Brambles and Thorns series|Of Brambles and Thorns]]
|Pirate Ship
|
|-

|-
!align=left|{{TDM-FM|90|Lockner Manor}}
|buck28
|{{Mirrorlink|http://www76.zippyshare.com/v/44108372/file.html}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16452-new-mission-lockner-manor/}}
|2014-08-02
|6
|No
|[[Fan_Mission_Series#Master thief Corso series|Corso]]
|Mansion/Estate Inn/Tavern
|
|-

|-
!align=left|{{TDM-FM|89|Ulysses: Genesis}}
|Sotha
|{{Mirrorlink|http://www4.zippyshare.com/v/67195436/file.html}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16428-fan-mission-ulysses-genesis-by-sotha-20140724/}}
|2014-07-24
|98
|No
|[[Fan_Mission_Series#Ulysses series|Ulysses]]
|Mansion/Estate
|Horror theme?
|-

|-
!align=left|{{TDM-FM|88|Penny Dreadful 2: All the way up}}
|Melan and Bikerdude
|{{Mirrorlink|https://mega.co.nz/#!EwoXHZYZ!tE_sKon2h4AWtWPNt9QS3FQClwmXdimhfjIMPcpCQ34}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16387-fan-mission-penny-dreadful-2-by-melan-and-bikerdude-2014078/}} [https://www.youtube.com/watch?v=WmPfCfbeWvg Trailer]
|2014-07-08
|102
|No
|[[Fan_Mission_Series#Penny Dreadful series|Penny Dreadful]]
|Thieves' Highway / Rooftop
|Spiders
|-

|-
!align=left|{{TDM-FM|87|Poets and Peasants}}
|Digi
|{{Mirrorlink|https://drive.google.com/file/d/0B1HHvWAgbWGfTkI0SXFubXZucXM}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16373-fan-mission-poets-peasants-by-digi-62914}}
|2014-06-29
|1
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|85|A Reputation to Uphold}}
|Springheel
|{{Mirrorlink|http://www.mindplaces.com/follow.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16204-fan-mission-a-reputation-to-uphold-by-springheel/}}
|2014-04-18
|25.5
|No
|[[Fan_Mission_Series#Corbin series|Corbin]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|86|Breaking Out the Fence}}
|Kyyrma
|{{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/breakingout.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16091-fan-mission-breaking-out-the-fence-17032014-by-kyyrma/}}
|2014-03-17
|11.6
|No
|[[Fan_Mission_Series#In A Time of Need series|In A Time of Need]]
|City Missions Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|83|Inn Business}} (v.1.48, 2014/03/08)
|RJFerret
|{{Mirrorlink|https://drive.google.com/file/d/0B81T2ZXLPqhTYWVaODRiSExGeGc}} {{Forumlink|1=http://forums.thedarkmod.com/topic/16018-fan-mission-inn-business-by-rjferret-20140303/}}
|2014-03-03
|6
|No
|
|Inn/Tavern City Streets
|
|-

|-
!align=left|{{TDM-FM|82|William Steele 3: Cleighmoor}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/16011-fan-mission-cleighmoor-by-grayman-201431/#entry338349/}}
|2014-03-01
|38
|No
|[[Fan_Mission_Series#William Steele series|William Steele]]
|Sewers Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|81|William Steele 2: Home Again}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/15919-fan-mission-home-again-by-grayman-2014212/page__fromsearch__1}}
|2014-02-12
|26
|No
|[[Fan_Mission_Series#William Steele series|William Steele]]
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|80|The Gatehouse}}
|Bikerdude Goldchocobo
|{{Mirrorlink|http://www.southquarter.com/tdm/fms/gatehouse.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15844-fan-mission-the-gatehouse-by-bikerdude-goldchocobo-20140114/}} [https://www.youtube.com/watch?v=kcIe2Ucojqw Briefing]
|2014-01-29
|100
|No
|Remake of Evilartist's Doom 3 mod
|Castle/Fortress
|Ghosts
|-

|-
!align=left|{{TDM-FM|79|Window of Opportunity}} (v.1.43, 2014/01/01)
|RJFerret
|{{Mirrorlink|https://drive.google.com/file/d/0B81T2ZXLPqhTWTMzQXZtMVFBSG8}} {{Forumlink|1=http://forums.thedarkmod.com/topic/15727-fan-mission-window-of-opportunity-by-rjferret-20140101/}}
|2014-01-01
|7
|No
|
|Outdoor/Caves
|Spiders (not in short mode)
|-

|-
!align=left|{{TDM-FM|78|In A Time Of Need}}
|kyyrma
| {{Mirrorlink|http://www.mediafire.com/download/a97or40t1xrybh3/timeofneed_v1.zip}} {{Forumlink|http://forums.thedarkmod.com/topic/15354-fan-mission-in-a-time-of-need-by-kyyrma-20131112/}}
|2013-11-12
|5.6
|No
|[[Fan_Mission_Series#In A Time of Need series|In A Time of Need]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|76|Requiem}}
|Moonbo
| {{Mirrorlink|http://www.mediafire.com/download/l6o3vvj9y78hu89/requiem.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15101-fan-mission-requiem-by-gelo-moonbo-fleisher-2013106/}}
|2013-10-08
|107.3
|No
|[[Fan_Mission_Series#Shadowcursed series|Shadowcursed]]
|Lost Civilizations Church/Cathedral
|Undead
|-

|-
!align=left|{{TDM-FM|75|Vengeance for a Thief Part 2}}
|Sir Taffsalot
| {{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/vfat2.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15051-fan-mission-vengeance-for-a-thief-part-2-by-sir-taffsalot-06092013/}}
|2013-09-06
|22
|No
|[[Fan_Mission_Series#Vengeance for a Thief series|VFAT]] [[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]]
|Museum Heists
|
|-

|-
!align=left|{{TDM-FM|74|Lords and Legacy}}
|Kvorning
| {{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/lordsnlegacy.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15016-fan-mission-lords-legacy-by-kvorning-20130830/}}
|2013-08-30
|45
|No
|
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|72|Not An Ordinary Guest}}
|Fieldmedic
| {{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/naog.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14965-fan-mission-not-an-ordinary-guest-by-fieldmedic-20130801/}}
|2013-08-01
|79.6
|No
|[[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|71|Penny Dreadful: Grail of Regrets}}
|Melan
| {{Forumlink|http://forums.thedarkmod.com/topic/14952-fan-mission-penny-dreadful-by-melan-20130728/}}
|2013-07-27
|74
|No
|[[Fan_Mission_Series#Penny Dreadful series|Penny Dreadful]]
|Horror
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|70|Solar Escape 1}}
|Tr00pertj
| {{Forumlink|http://forums.thedarkmod.com/topic/14944-fan-mission-solar-escape-1/}}
|2013-07-22
|6
|No
|
|Mansion/Estate Sewers
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|69|The Lich Queen's Demise}}
|Sotha
|{{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/lich_queens_demise.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14826-fan-mission-the-lich-queens-demise-by-sotha-20130520/unread/}}
|2013-05-20
|97.6
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]] [[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]] (Winner)
|Horror
|Undead
|-

|-
!align=left|{{TDM-FM|77|Old Habits Rebuild}}
|Obsttorte
|{{Bloodgate|mc.pk4}} {{Mirrorlink|http://www.mediafire.com/download/u2gwucibh17c45a/oldhabits.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14827-fan-mission-old-habits-rebuild-by-obsttorte-20052013/}}
|2013-05-20
|28.6
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|68|The Builder's Blocks}}
|Jesps
|{{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/builders_blocks.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14592-unusual-gameplay-contest-fm-the-builders-blocks-by-jesps/}}
|2013-03-18
|2.85
|No
|[[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]]
|Experimental
|
|-

|-
!align=left|{{TDM-FM|67|Crystal Grave}} (v.2.0, 2013/02/09)
|ERH+ Bikerdude
|{{Mirrorlink|https://dl.dropbox.com/u/17706561/crystalgravev2.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14510-fan-mission-crystal-grave-v2-by-erh-and-bikerdude-20130209/unread/}}
|2011-11-15
|12.4
|No
|
|Horror
|Undead
|-

|-
!align=left|{{TDM-FM|66|The Builder Roads}}
|Obsttorte
|{{Forumlink|http://forums.thedarkmod.com/topic/14449-fan-mission-the-builder-roads-by-obsttorte-20130119/}}
|2013-01-19
|?
|No
|
|Horror
|Ghosts
|-

|-
!align=left|{{TDM-FM|65|William Steele 1: In the North}}
|grayman
|{{Bloodgate|ws1_north.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14214-fan-mission-in-the-north-by-grayman-20121020/}}
|2012-10-20
|39.8
|No
|[[Fan_Mission_Series#William Steele series|William Steele]]
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|64|Old Habits}}
|Obsttorte
|{{Bloodgate|mc.pk4}} {{Mirrorlink|http://www.mediafire.com/download.php?andes2xnsonssfj}} {{Forumlink|http://forums.thedarkmod.com/topic/14206-fan-mission-old-habits-by-obsttorte-20121019/}}
|2012-10-19
|12.8
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|63|Deceptive Shadows}}
|ShadowHide
|{{Bloodgate|DeceptiveShadows.pk4}} {{Mirrorlink|http://www.sendspace.com/file/jzr9s7}} {{Forumlink|http://forums.thedarkmod.com/topic/14103-fan-mission-deceptive-shadows-by-shadowhide-16sep12/}}
|2012-09-16
|22.4
|No
|
|Outdoor/Pagan
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|62|Vengeance for a Thief: Part 1}}
|Sir Taffsalot
|{{Bloodgate|VFAT1.pk4}} {{Mirrorlink|https://dl.dropbox.com/u/17706561/VFAT1.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14068-fan-mission-vengeance-for-a-thief-part-1-by-sir-taffsalot-06092012/}}
|2012-09-06
|20.9
|No
|[[Fan_Mission_Series#Vengeance for a Thief series|VFAT]]
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|61|The Phrase Book}}
|Sotha
|{{Bloodgate|phrase_book.pk4}} {{Mirrorlink|http://dl.dropbox.com/u/17706561/phrase_book.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13799-fan-mission-the-phrase-book-by-sotha-20120512/}}
|2012-05-11
|24
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|60|In Remembrance of Him}}
|RPGista
|{{Bloodgate|remembrance.pk4}} {{Mirrorlink|http://dl.dropbox.com/u/17706561/remembrance.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13749-fan-mission-in-remembrance-of-him-by-rpgista/}}
|2012-04-22
|27.6
|No
|[[Fan_Mission_Contests#2012_Community_Beginner_Contest|CBC 12]]
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|59|Rightful Property}}
|jysk
|{{Bloodgate|rightful.pk4}} {{Mirrorlink|http://dl.dropbox.com/u/17706561/rightful1.1b.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13711-fan-mission-rightful-property-by-jysk-20120413/}}
|2012-04-12
|22.5
|No
|[[Fan_Mission_Contests#2012_Community_Beginner_Contest|CBC 12]]
|Bank Jobs
|Spiders
|-

|-
!align=left|{{TDM-FM|58|Sneak and Destroy}}
|SeriousToni
|{{Bloodgate|kneipe24.pk4}} {{Mirrorlink|http://minus.com/mVcf61n3G/1f}} {{Forumlink|http://forums.thedarkmod.com/topic/13706-fan-mission-sneak-destroy-by-serioustoni-beginners-contest-2012/}}
|2012-04-11
|158
|No
|[[Fan_Mission_Contests#2012_Community_Beginner_Contest|CBC 12]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|56|House of Theo}}
|Theothesnopp
|{{Bloodgate|houseoftheo.pk4}} {{Mirrorlink|http://www.gamefront.com/files/21053391/houseoftheo__2__2.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13242-fan-mission-house-of-theo/}}
|2011-12-04
|6.2
|No
|
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|53|Dragon's Claw}}
|Bikerdude, Flanders (map assets)
|{{Bloodgate|claw.pk4}}{{Mirrorlink|http://www.gamefront.com/files/20948800/claw.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13181-fan-missiondragons-claw-by-b1k3rdude-31102011/}}
|2011-10-31
|98
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|52|A Night to Remember}} (v2.0, 2018/05/28)
|Fieldmedic
|{{Bloodgate|antr.pk4}} New → {{Forumlink|http://forums.thedarkmod.com/topic/19452-a-night-to-remember/}} Old → {{Forumlink|http://forums.thedarkmod.com/topic/13177-fan-mission-a-night-to-remember-by-fieldmedic-20111030/}}
|2011-10-31
|33
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Mansion/Estate Horror
|Ghosts
|-

|-
!align=left|{{TDM-FM|51|The Creeps}}
|Mortem Desino
|{{Bloodgate|thecreeps.pk4}}{{Mirrorlink|http://www.gamefront.com/files/20939925/thecreeps.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13176-fan-mission-creeps-the-20111030-by-mortem-desino/}}
|2011-10-30
|61
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Horror
|Ghosts
|-

|-
!align=left|{{TDM-FM|50|House in Blackbog Hollow}}
|Stumpy
|{{Bloodgate|blackbog.pk4}}{{Mirrorlink|http://www.bookofages.co.uk/doom3/mods/blackbog.html}} {{Forumlink|http://forums.thedarkmod.com/topic/13172-fan-mission-house-in-blackbog-hollow-by-stumpy-20111028/}}
|2011-10-28
|12
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Horror
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|49|Let Sleeping Thieves Lie}}
|Sir Taffsalot, Bikerdude
|{{Bloodgate|lstl.pk4}}{{Mirrorlink|http://www.mediafire.com/?zkd1jn4lpwgioh9}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/13153-let-sleeping-thieves-lie-by-sir-taffsalot-bikerdude-20102011/}}
|2011-10-20
|13
|No
|
|Tombs, Catacombs & Crypts
|Undead
|-

|-
!align=left|{{TDM-FM|48|Samhain Night}}
|PranQster
|{{Bloodgate|samhain.pk4}}{{Mirrorlink|http://jdchoate.mcn.org/games/darkmod/samhain.zip}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/13127-fan-mission-samhain-night-on-bone-hill-by-pranqster-20111009/}}
|2011-10-09
|10
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Horror
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|47|A Score to Settle}}
|Springheel
|{{Bloodgate|score_to_settle.pk4}}{{Mirrorlink|http://www.mediafire.com/?f3o7hm4h4ew7o3l}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12894-fan-mission-%2348-a-score-to-settle-by-springheel-20110701/}}
|2011-07-01
|135
|No
|[[Fan_Mission_Series#Corbin series|Corbin]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|46|Siege Shop}} (v3.0 2013/10/10)
|PranQster and Lowenz
|{{Bloodgate|siegeshop.pk4}}{{Mirrorlink|http://jdchoate.mcn.org/games/darkmod/siegeshop.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12874-fan-mission-the-siege-shop-by-pranqster-20110626/}}
|2011-06-26
|20.51
|No
|
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|44|Alberic's Curse}}
|Bikerdude
|{{Bloodgate|alberic.pk4}} {{Mirrorlink|http://www.gamefront.com/files/20459738/alberic.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12850-fan-mission-alberics-curse-by-b1k3rdude-20062011/}}
|2011-06-20
|29
|No
|[[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]] (Winner) T2 FM homage
|Church/Cathedral
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|45|Reap As You Sow}}
|Fieldmedic
|{{Bloodgate|reap.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12849-fan-mission-reap-as-you-sow-by-fieldmedic-20110619/}}
|2011-06-19
|52
|No
|[[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|Outdoor/Daylight Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|43|Rake Off}}
|Jesps
|{{Bloodgate|rake_off.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12846-fm-rake-off-19-06-2011/}}
|2011-06-19
|8
|No
|[[Fan_Mission_Series#Selis Woderose series|Selis Woderose]] [[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|42|Winter Harvest}} (v2.0 2011/07/24 with Bikerdude)
|ShadowHide
|{{Bloodgate|winterharvest.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12690-seasons-contest-entry-winter-harvest-by-shadowhide/}}
|2011-05-08
|10
|No
|[[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|Outdoor/Pagan
|Spiders
|-

|-
!align=left|{{TDM-FM|41|Fiasco at Fauchard Street}}
|Melan
|{{Bloodgate|fauchard.pk4}} {{Mirrorlink|https://rapidshare.com/files/460141132/fauchard.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12655-fan-mission-fiasco-at-fauchard-street-by-melan-20110501//}}
|2011-05-01
|62
|No
|[[Fan_Mission_Series#Sir Talbot series|Sir Talbot]]
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|40|Mandrasola}}
|Sotha
|{{Bloodgate|mandrasola.pk4}} {{Mirrorlink|http://www.mediafire.com/?2ox2nbhh796ne71}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12575-fan-mission-mandrasola-by-sotha-20110410/}}
|2011-04-10
|10
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]] [[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|City Missions
|Undead
|-

|-
!align=left|[http://www.southquarter.com/tdm/fms/yantdm1.1.pk4 Q4 Conversion: Yan's Test]
|Bikerdude
|{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12506-fan-mission-q4-map-conversion-yantdm1-280311/}}
|2011-03-28
|28
|No
|
|
|
|-

|-
!align=left|{{TDM-FM|38|The Transaction}}
|Sotha
|{{Bloodgate|transaction.pk4}} {{Mirrorlink|http://www.mediafire.com/?ux7mx79wumnvcb6}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12408-fan-mission-the-transaction-by-sotha-20110304/}}
|2011-03-04
|10
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|13|Return to the City}} (v3.0 2015/01/03)
|Melan, Bikerdude
|{{Bloodgate|ReturnToTheCityV2.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10509-fan-mission-return-to-the-city-by-melan-20100110/}} {{Forumlink|1=http://www.ttlg.com/forums/showthread.php?t=130519/}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12390-fan-mission-return-to-the-city-v2-01032011/}}
|2010-01-10
|26
|No
|[[Fan_Mission_Series#Sir Talbot series|Sir Talbot]] [[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]] (Winner)
|City Missions
|
|-

|-
!align=left|{{TDM-FM|39|Lockdown}}
|GameDevGoro Bikerdude Fidcal
|{{Bloodgate|lockdown1_2_1.pk4}} {{Mirrorlink|http://www.fidcal.com/darkuser/missions/lockdown1_2_1.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12064-fm-lockdown-part-1-by-gamedevgoro-and-bikerdude-20101224/}}
|2010-12-25
|3
|No
|Lockdown 1
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|37|Flakebridge Monastery}}
|Jesps
|{{Bloodgate|flakebridge.pk4}} {{Mirrorlink|http://www.file-upload.net/download-3024426/flakebridge.pk4.html}} {{Mirrorlink|http://rapidshare.com/files/434997519/flakebridge.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11991-fm-flakebridge-monastery-by-jesps/}}
|2010-12-05
|16
|No
|[[Fan_Mission_Series#Selis Woderose series|Selis Woderose]]
|Church/Cathedral
|Undead
|-

|-
!align=left|{{TDM-FM|36|Knighton Manor, The}}
|Sotha
|{{Bloodgate|knighton_manor.pk4}} {{Mirrorlink|http://www.mediafire.com/?xrdts3j4t2qxre2}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11898-fan-mission-the-knighton-manor-by-sotha-20101109/page__view__getnewpost}}
|2010-11-09
|21
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|35|St Albans Cathedral}} (v2.0 2014/06/11)
|Bikerdude
|{{Bloodgate|stac160.pk4}} [[http://www.bloodgate.com/fms/stac142.pk4 Classic]] {{Mirrorlink|http://www.filefront.com/17464439/stac141.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16343-fan-mission-st-albans-cathedral-v20-11062014/}} {{Loot|FM:TDM_St_Alban's_Cathedral_-_Bikerdude}}
|2010-11-01
|67
|No
|[[Fan_Mission_Series#St Alban series|St Alban]]
|Church/Cathedral
|Undead
|-

|-
!align=left|{{TDM-FM|33|Swing}}
|Komag
|{{Bloodgate|swing_v1.2.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11660-vertigo-contest-entry-swing-by-komag-20100825/}} {{Loot|FM:TDM_Swing_-_Komag}}
|2010-08-25
|3
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Platforming/Jumping Experimental
|
|-

|-
!align=left|{{TDM-FM|32|The Caduceus of St. Alban}} (v.1.5.5 2010/08/26)
|Bikerdude
|{{bloodgate|stalban.pk4}} {{Mirrorlink|http://www.filefront.com/17237609/stalban.pk4/}}{{Forumlink|http://forums.thedarkmod.com/topic/11644-the-caduceus-of-st-alban-vertical-fm-contest-entry-aug-8th-2010/}}
|2010-08-23
|11.3
|No
|[[Fan_Mission_Series#St Alban series|St Alban]] [[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Church/Cathedral
|Spiders
|-

|-
!align=left|{{TDM-FM|30|Somewhere Above the City}} (v1.1 2010/08/27)
|grayman
|{{Bloodgate|somewhere1.1.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11619-vertical-contest-mission-somewhere-above-the-city-by-grayman-aug-20-2010/}} {{Loot|FM:TDM_Somewhere_Above_the_City_-_grayman}}
|2010-08-20
|11
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Tombs, Catacombs & Crypts
|
|-

|-
!align=left|{{TDM-FM|29|Betrayal}} (v.1.1, 2010/09/01)
|Fieldmedic
|{{Bloodgate|betrayal.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11605-betrayal-by-fieldmedic-20100817-summer-fm-vertical-contest-entry/}} {{Loot|FM:TDM_Awaiting_the_Storm_-_HappyCheeze}}
|2010-08-17
|12
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Horror
|Undead
|-

|-
!align=left|{{TDM-FM|31|Rift, The}}
|Baddcog
|{{Bloodgate|rift.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11599-vert-contest-mission-the-rift-by-baddcog-aug-15-2010/}}
|2010-08-15
|10
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Lost Civilizations
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|34|Illusionist's Tower}}
|stumpy
|{{Bloodgate|holetower.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11541-illusionists-tower-by-stumpy-201085-summer-fm-vertical-contest-entry}} {{Forumlink|1=http://www.bookofages.co.uk/doom3/mods/holetower.html}} {{Loot|FM:TDM_Illusionist%27s_Tower_-_stumpy}}
|2010-08-05
|9
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Horror Experimental
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|28|Mad's Mountain}}
|Jesps
|{{Bloodgate|madmountain.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11510-fan-mission-mads-mountain-by-jesps-20100731}} {{Loot|FM:TDM_Lord_Dufford%27s_-_stumpy}}
|2010-07-31
|2
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Outdoor/Caves
|
|-

|-
!align=left|{{TDM-FM|27|Glenham Tower, The}}
|Sotha
|{{Bloodgate|glenham_tower.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11423-fan-mission-the-glenham-tower-by-sotha-20100717}}
|2010-07-17
|5
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]] [[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]] (Winner)
|Castle/Fortress Horror
|Undead
|-

|-
!align=left|{{TDM-FM|25|Pandora's Box}}
|Jesps, Fidcal
|{{Bloodgate|pandoras_box.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11381-fan-mission-pandoras-box-by-jesps20100711}} {{Loot|FM:TDM_Pandora%27s_Box_-_Jesps}}
|2010-07-11
|7
|No
|
|Pirate Ship Experimental
|
|-

|-
!align=left|{{TDM-FM|23|Beleaguered Fence, The}}
|Sotha
|{{Bloodgate|beleaguered_fence.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11298-fan-mission-the-beleaguered-fence-by-sotha-20100623}} {{Loot|FM:TDM_The_Beleaguered_Fence_-_Sotha}}
|2010-06-23
|11
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|22|Special Delivery, A}}
|Silencium18
|{{Bloodgate|delivery.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11247-fan-mission-a-special-delivery-by-silencium1820100612}} {{Loot|FM:TDM_A_Special_Delivery_-_Silencium18}}
|2010-06-12
|2
|No
|
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|21|Alchemist, The}} (2010/06/04)
|Sotha, Fidcal
|{{Bloodgate|alchemist.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11170-fan-mission-the-alchemist-by-sotha-fidcal20100601}} {{Loot|FM:TDM_The_Alchemist_-_Sotha_%26_Fidcal}}
|2010-06-01
|27
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|20|Awaiting The Storm}}
|HappyCheeze
|{{Bloodgate|storm.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11095-fm-awaiting-the-storm-by-happycheeze-20200522}} {{Loot|FM:TDM_Awaiting_the_Storm_-_HappyCheeze}}
|2010-05-22
|4
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|19|Sound Alert & Blackjack Trainer}}
|Dark Mod Team
|
|2010-05-14
|0.2
|No
|
|Training
|
|-

|-
!align=left|{{TDM-FM|18|No Honor Among Thieves}} (v.3.0, 2015/05/30)
|Goldchocobo, RailGun, Mortem Desino, Bikerdude
|{{Mirrorlink|http://tinyurl.com/2a9mdcs}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10993-fan-mission-no-honor-among-thieves-20100429}} {{Loot|FM:TDM_No_Honor_Among_Thieves_-_Goldchocobo}}
|2010-04-29
|203
|No
|
|Church/Cathedral; City Missions; Outdoor/Pagan, Mansion/Estate
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|17|Heart of Lone Salvation, The}} (v.2.0, 2014/04/12)
|Fidcal, Baddcog, Bikerdude
|{{Bloodgate|heart.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/topic/10878-fan-mission-the-heart-of-lone-salvation-by-fidcal-baddcog-bikerdude-20100402/?p=213506}} {{Walkthrough|FM:TDM_The_Heart_of_Lone_Salvation_-_Fidcal_%26_Baddcog_%26_Bikerdude}} {{loot|FM:TDM_The_Heart_of_Lone_Salvation_-_Fidcal_%26_Baddcog_%26_Bikerdude}}
|2010-04-02
|41
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|City Missions
|Spiders
|-

|-
!align=left|{{TDM-FM|73|Lord Dufford's}}
|stumpy
|{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10868-fan-mission-lord-duffords-20100331}} {{Loot|FM:TDM_Lord_Dufford%27s_-_stumpy}}
|2010-03-31
|22
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|16|Builder's Influence, The}} (2010/03/23)
|Railgun, Springheel
|{{Bloodgate|builders_influence.pk4}} {{Mirrorlink|http://www.fidcal.com/darkuser/missions/builders_influence.pk4}}{{Forumlink|http://forums.thedarkmod.com/index.php?/topic/10811-fan-mission-the-builders-influence-20100320/}} {{Loot|FM:TDM_The_Builders_Influence_-_Railgun%26Springheel}}
|2010-03-20
|15
|No
|[[Fan_Mission_Series#Corbin series|Corbin]]
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|14|Business as Usual}} (v2.0 2011/09/24)
|Bikerdude
|{{Bloodgate|business.pk4}}{{Mirrorlink|1=http://rapidshare.com/files/335299431/business.pk4.html}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10533-fan-mission-business-as-usual-by-b1k3rdude-14012010-christmas-fm-contest-entry/page__view__findpost__p__207055}}
|2010-01-14
|4
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Sewers
|
|-

|-
!align=left|{{TDM-FM|12|Sons of Baltona 1, The}}
|Carnage
|{{Bloodgate|sons_of_baltona_1.pk4}} {{Mirrorlink|1=http://www.mediafire.com/?m4ywobjodm0}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10498-fan-mission-the-sons-of-baltona-1-by-carnage-20100109}}
|2010-01-09
|3
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]] / Baltona 1
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|11|Living Expenses}}
|Sonosuke
|{{Bloodgate|living_expenses.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10451-fm-living-expenses-by-sonosuke-2-jan-10/page__view__findpost__p__205386}}
|2010-01-02
|6
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|10|Trapped!}}
|RailGun
|{{Bloodgate|trapped.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10442-fm-trapped-by-railgun-dec-30/page__view__findpost__p__205092}}
|2009-12-30
|6
|No
|
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|8|Parcel, The}}
|Xonze
|{{Bloodgate|parcel.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10404-fm-the-parcel-by-xonze-dec-24/page__view__findpost__p__204459}}
|2009-12-24
|7
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|9|Too Late}}
|Nielsen74
|{{Bloodgate|too_late.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10400-fm-too-late-by-nielsen74-24-dec-09/page__view__findpost__p__204396}}
|2009-12-24
|4
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|7|Thieves}}
|Silencium, RailGun, Fidcal
|{{Bloodgate|thieves.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10286-fm-the-thieves-nov-2509/}}
|2009-11-26
|9
|No [https://www.moddb.com/mods/the-dark-mod/addons/unofficial-thieves-efx Unofficial EFX Build]
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|6|Patently Dangerous}} (v.2.0, 2013/10/08)
|demagogue
|{{Bloodgate|patently_dangerous.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10125-fm-patently-dangerous-oct3109/page__view__findpost__p__199324/}}
|2009-10-31
|24
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|5|Dark Mod Training Mission, The}}
|TDM Team
|{{Bloodgate|training_mission.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9932-fm-training-mission-17-oct-09/}}
|2009-10-17
|6
|No
|[[Fan_Mission_Series#Introduction_campaign|Official Campaign]]
|Training Platforming/Jumping
|
|-

|-
!align=left|{{TDM-FM|2|Crown of Penitence, The}}
|Jesps
|{{Bloodgate|crow_of_penitence.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9934-fm-crown-of-penitence-by-jesps-17-oct-09/}}
|2009-10-16
|12
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|3|Chalice of Kings, The}} (v.2.0, 2015/09/24) (Bikerdude and Xarg)
|Fidcal
|{{Bloodgate|chalice.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9935-fm-chalice-of-kings-by-fidcal-17-oct-09/}} {{Loot|FM:TDM_Chalice_of_Kings_-_Fidcal}}
|2009-10-15
|3
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|1|Outpost, The}}
|angua, greebo
|{{Bloodgate|outpost.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9937-fm-the-outpost-by-angua-greebo-17-oct-09/}}
|2008-12-23
|2
|No
|
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|15|Mission 2: Tears of Saint Lucia, The}} (v.3.0, 2017/02/14)
|TDM Team
|{{Bloodgate|saintlucia.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10579-fan-mission-the-tears-of-st-lucia-20081021/page__view__findpost__p__207972}} {{Loot|FM:TDM_The_Tears_of_Saint_Lucia_-_jdude}} [https://www.youtube.com/watch?v=yrGxoi3LSGg Briefing]
|2008-10-21
|20.3
|No
|[[Fan_Mission_Series#Introduction_campaign|Official Campaign]]
|Church/Cathedral
|Spiders
|-

|-
!align=left|{{TDM-FM|57|Closemouthed Shadows}} (v.2.0, 2012/01/15)
|LordSavage, Bikerdude
|{{Bloodgate|closemouthed_shadows.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/topic/13383-fan-mission-closemouthed-shadows-2008-reworked-for-tdm-107-20120115/}}
|2008-09-21
|2
|No
|Closemouthed Shadows 1
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|24|Thief's Den}} (v.2.0, 2010/07/04)
|Fidcal, greebo
|{{Bloodgate|thiefs_den.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11347-fan-mission-thiefs-den-re-release-by-fidcal20100704}} {{Walkthrough|FM:TDM_Thief's_Den_-_Fidcal}} {{Loot|FM:TDM_Thief%27s_Den_-_Fidcal}}
|2008-01-18
|3
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|City Missions
|
|}

To see a speculative list of Upcoming Fan Missions, please visit: [[Upcoming Fan Missions]]

== Table notes ==

'''Links Key'''
{|class="wikitable" border=1 style="border-collapse: collapse;" cellspacing=0 cellpadding=2
|-
|[http://wik.thedarkmod.com/images/b/be/Icon_forum.png http://wiki.thedarkmod.com/images/b/be/Icon_forum.png]
|Link to discussion in Forums
|-
|{{Mirrorlink|}}
|Misc. download mirror
|-
|{{Bloodgate|}}
|Bloodgate download mirror
|-
|{{Loot|}}
|Loot list
|-
|{{Walkthrough|}}
|Walkthrough
|}

----

'''Mission Type Key'''

''Bear in mind that individual FMs can have combinations of two or three of these overarching genres/themes, rather than just a single one.''

{|class="wikitable" border=1 style="border-collapse: collapse;" cellspacing=0 cellpadding=2
|-
|'''''Bank Jobs'''''
|Fan mission involving a heist or other thievy action inside a local banking institution. Will often contain the outsmarting of security systems, gaining access to a safe and cracking its code.
|-
|'''''Castle/Fortress'''''
|Fan mission involving a heist or other thievy action inside or outside a castle or fortress, either one that serves as a military garrison, or as someone's private residence. Frequently involves background characters from the nobility.
|-
|'''''City Missions'''''
|Fan mission that is set mainly in the streets and public spaces of an urban area, such as a town or city. Though the player is most often out on the streets, these missions tend to also involve some degree of exploration and infiltration into private and public buildings alike.
|-
|'''''Church/Cathedral'''''
|Fan mission set in and around religious buildings and institutions, such as churches, monasteries, cathedrals, church bureaus, church workshops, etc. Frequently involves [[Clergy/Builder_Characters|ecclesiastical characters]] from the TDM setting's [[Builders|Builder Church]].
|-
|'''''Experimental'''''
|Fan mission which involves some creative design or gameplay element that isn't typical for the vast majority of TDM missions. FMs set in highly unusual environments, or with a puzzle-like nature, can fit under this label.
|-
|'''''Inn/Tavern'''''
|Fan mission set mostly in and around an inn, tavern or shanty. Usually focused on robbing some rich guest, acquiring an item stored by the guest at the inn, or gathering intel at the inn.
|-
|'''''Jail/Prison'''''
|Fan mission involving an escape from a prison (by the imprisoned player character), infiltration of a prison to gather intel from inmates or help an inmate escape the prison, etc.
|-
|'''''Lost Civilizations'''''
|Fan mission focused on the exploration of ancient ruins, whether above ground or in deep subterranean caverns. Can often overlap with the ''Horror'' or ''Tombs, Catacombs & Crypts'' type of mission, but not necessarily.
|-
|'''''Horror'''''
|Fan mission with an overt horror theme. Depending on the author's approach and intentions, it can focus on psychological horror, or horror based on danger from supernatural threats, or varying combinations of both.
|-
|'''''Mansion/Estate'''''
|Fan mission involving a heist or other thievy action inside someone's private residence (a fancy house, a manor house) and its surrounding grounds. Frequently involves background characters from the nobility or the more affluent townsmen or citizens.
|-
|'''''Museum Heists'''''
|Fan mission focusing on a heist in a museum, art gallery or other institution storing priceless artefacts, artworks, gemstone collections, etc.
|-
|'''''Outdoor/Caves'''''
|Fan mission set in a mostly natural outdoor environment, but involving the exploration of natural caves and caverns.
|-
|'''''Outdoor/Daylight'''''
|Fan mission set in a mostly outdoor environment, during the daytime (in contrast to the usual TDM missions, set at night time or early dusk).
|-
|'''''Outdoor/Pagan'''''
|Fan mission set in a mostly natural outdoor environment, involving some presence of [[Pagans|pagan tribes]] from TDM's setting. Perhaps even pagan camps and settlements.
|-
|'''''Pirate'''''
|Fan mission involving the presence of characters engaging in piracy or smuggling, and various related piratical themes. Can overlap with the ''Ship'' type of mission, but not necessarily.
|-
|'''''Platforming/Jumping'''''
|Fan mission focusing on testing the player's movement, jumping and climbing skills, with or without equipment.
|-
|'''''Sewers'''''
|Fan mission which involves the use of the city sewers or others sewers in some way, often as a stealthy means of entry or escape.
|-
|'''''Ship'''''
|Fan mission which takes place aboard a vessel, in port or at sea, or otherwise involves ships to a great degree. Can overlap with the ''Pirate'' type of mission, but not necessarily.
|-
|'''''Thieves' Highway / Rooftop'''''
|Fan mission involving a lot of movement and travel on the rooftops of a town or city (colloquially "The Thieves' Highway").
|-
|'''''Tombs, Catacombs & Crypts'''''
|Fan mission involving the exploration of old tombs, catacombs and crypts, often for the purposes of treasure and artefact hunting. Can often overlap with the ''Horror'' or ''Lost Civilizations'' type of mission, but not necessarily.
|-
|'''''Training'''''
|Fan mission label that is unique to the official Training Mission, an open-ended tutorial mission where players can practice and test their TDM gameplay skills at their own leisure, and to the smaller blackjacking-trainer FM, which focuses on practicing NPC knockouts by the player.
|-
|'''''Warehouse'''''
|Fan mission which takes place in and around a warehouse, usually in some industrial area of a city, or at a port.
|}

----

'''Contest Key'''

GCC 09: [[Fan_Mission_Contests#2009 Grand Christmas Contest|Grand Christmas Contest 2009]]

SVC 10: [[Fan_Mission_Contests#2010 Summer Vertical Contest|Summer Vertical Contest 2010]]

CSC 11: [[Fan_Mission_Contests#2011 Community Seasons Contest|Community Seasons Contest 2011]]

HSC 11: [[Fan_Mission_Contests#2011 Halloween Speed-build Contest|Halloween Speed-Build Contest 2011]]

CBC 12: [[Fan_Mission_Contests#2012 Community Beginner Contest|Community Beginner Contest 2012]]

CUC 13: [[Fan_Mission_Contests#2013 Community Unusual Contest|Community Unusual Contest 2013]]

HSC 14: [[Fan_Mission_Contests#2014 Halloween Speed-build Contest|Halloween Speed-Build Contest 2014]]

HSC 15: [[Fan_Mission_Contests#2015 Halloween Speed-build Contest|Halloween Speed-Build Contest 2015]]

----

== Editing this table ==
* Please only include playable missions that are fully released, not those currently in development or testing. Tutorials, demos, prefabs, etc. should be listed elsewhere.
* A mission title may be listed in plain text as a record of release, or preferably a link to an information page or primary direct download.
* List by release date descending (newest at the top).
* If a fan mission only has a single mirror/host please consider adding additional mirrors.

== See also ==
* [[Fan Mission Series]] - An overview of all currently known series or campaigns of fan missions interconnected by their stories or characters. There are already plenty in TDM, and have been since its early days as an expandable game.
* [[Mission recommendation discussions]] - An overview of past discussions on what FMs the community recommends to players looking for various challenges (difficulty, size, theme, setting, objectives, etc.).
* [[Fan Mission Contests]] - An overview of past and present contests in Fan Mission creation, by members of the TDM community.
* [[Upcoming Fan Missions]] - An overview of Fan Missions in development or tentatively planned. (''Do not'' edit the overview.)

{{general|sort=Fan Missions}}
[[Category:Fan Missions]]
[[Category:Official FMs| ]]

Fan Missions for The Dark Mod

2019-09-03T18:24:51Z

VanishedOne: Why was Vitalic Fever listed as a city mission?

__NOTOC__
{{infobox|<center>'''Big Ugly Disclaimer:'''</center> '''The Dark Mod''' team does not necessarily support or endorse content listed here, and only hosts missions listed on the [http://www.thedarkmod.com/ official TDM website]. This is a community maintained list, and an ongoing work in progress. Most of the mirror links in this list are dead or are for missions that are not 2.0 compliant. Mission entries which are suspected to violate copyright must be text-only, and cannot contain links. Report and/or remove links found in violation of this rule.}}

* For details about editing this table, see [[#Editing_this_table|below]].
* For details about how to install Fan Missions please visit: [[Installing and Running Fan Missions]]
* To sort by a different criterion, click the [[Image:Sort none.gif]] icon in the relevant column header.

{|class="wikitable sortable" border=1 style="border-collapse: collapse;" cellspacing=0 cellpadding=2 width=100%
|-
!bgcolor=#d0d0e0 width="21%"|Fan Mission Title
!bgcolor=#d0d0e0 width="11%"|Author(s)
!bgcolor=#d0d0e0 width="4%" class="unsortable"|Links
!bgcolor=#d0d0e0 width="5%"|First Release
!bgcolor=#d0d0e0 width="2%"|Size (MB)
!bgcolor=#d0d0e0 width="3%"|EFX Reverb
!bgcolor=#d0d0e0 width="10%"|Series
!bgcolor=#d0d0e0 width="13%"|Mission Type
!bgcolor=#d0d0e0 width="6%"|Spiders and Undead
|-



|-
!align=left|{{TDM-FM|138|Hidden Hands: Vitalic Fever}}
|JackFarmer
|{{Forumlink|http://forums.thedarkmod.com/index.php?/topic/20051-hidden-hands-vitalic-fever-20072019}}
|2019-07-20
|269
|Yes
|Hidden Hands 2
|Mansion/Estate
|Spiders, undead
|-

|-
!align=left|{{TDM-FM|137|Chronicles of Skulduggery 2: Pearls and Swine}}
|Bienie
|{{Forumlink|http://forums.thedarkmod.com/topic/19975-fan-mission-chronicles-of-skulduggery-2-a-precarious-position-20190504/}}
|2019-05-04
|14.5
|Yes
|[[Fan_Mission_Series#Chronicles_of_Skulduggery_series|Chronicles of Skulduggery]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|136|William Steele 5: Commerce Bank}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19957-fan-mission-commerce-bank-by-grayman-2019410/}}
|2019-04-10
|30
|Yes
|[[Fan_Mission_Series#William_Steele_series|William Steele]]
|Bank Jobs
|
|-

|-
!align=left|{{TDM-FM|135|Marsh of Rahena}}
|ERH+
|{{Forumlink|http://forums.thedarkmod.com/topic/19951-fan-mission-marsh-of-rahena-by-erh-201945}}
|2019-04-05
|60.3
|Yes
|
|Castle/Fortress, Horror
|Undead, Spiders, Horror Themes
|-

|-
!align=left|{{TDM-FM|134|Shadows of Northdale ACT 2}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/19936-fan-mission-shadows-of-northdale-act-ii-by-goldwell-20190320/}} [https://www.youtube.com/watch?v=KO-eIOX9nqI Briefing]
|2019-03-20
|417
|Yes
|[[Fan_Mission_Series#Shadows of Northdale series|Shadows of Northdale]]
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|133|Cleaning Up the Neighbourhood}}
|some1stoleit and Bikerdude
|{{Forumlink|http://forums.thedarkmod.com/topic/19898-fan-mission-cleaning-up-the-neighbourhood-by-some1stoleitbikerdude-20190219/}}
|2019-02-18
|34.3
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|132|Hidden Hands: Initiation}}
|JackFarmer
|{{Forumlink|http://forums.thedarkmod.com/topic/19796-hidden-hands-initiation-27122018/}}
|2018-12-27
|92.5
|Yes
|
|Mansion/Estate Ship
|Spiders, Extra-natural entities
|-

|-
!align=left|{{TDM-FM|131|The Night of Reluctant Benefaction}}
|Bienie
|{{Forumlink|http://forums.thedarkmod.com/topic/19787-fan-mission-the-night-of-reluctant-benefaction/}}
|2018-12-24
|11.9
|Yes
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|130|Mission of Mercy}}
|joebarnin
|{{Forumlink|http://forums.thedarkmod.com/topic/19642-fan-mission-mission-of-mercy-by-joebarnin-20180914/}}
|2018-09-14
|10.1
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|129|William Steele 4: The Warrens}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19618-fan-mission-the-warrens-by-grayman-201891/}}
|2018-09-01
|53
|Yes
|[[Fan_Mission_Series#William_Steele_series|William Steele]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|128|Braeden Church}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19533-fan-mission-braeden-church-by-grayman-201871/}}
|2018-07-01
|24
|No
|
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|127|Chronicles of Skulduggery: Pearls and Swine}}
|Bienie
|{{Forumlink|http://forums.thedarkmod.com/topic/19439-chronicles-of-skulduggery-pearls-and-swine/}}
|2018-05-25
|23
|Yes
|[[Fan_Mission_Series#Chronicles_of_Skulduggery_series|Chronicles of Skulduggery]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|126|Shadows of Northdale ACT I}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/19368-fan-mission-shadows-of-northdale-act-i-by-goldwell-20180323/}} [https://www.youtube.com/watch?v=p4nP3lYd6wg Briefing]
|2018-03-23
|295
|Custom (not EFX)
|[[Fan_Mission_Series#Shadows of Northdale series|Shadows of Northdale]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|125|Sir Taffsalot's Sword}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19361-fan-mission-sir-taffsalots-sword-by-grayman-2018318/}}
|2018-03-17
|11.3
|No
|
|Mansion/Estate In memoriam of Gary (Sir Taffsalot) {{Forumlink|http://forums.thedarkmod.com/topic/19306-sad-news-we-lost-one-of-our-own-sir-taffsalot/}}
|
|-

|-
!align=left|{{TDM-FM|124|The Arena}}
|ERH+
|{{Forumlink|http://forums.thedarkmod.com/topic/19350-fan-mission-the-arena-by-erh/}}
|2018-03-12
|3
|No
|
|Arena Deathmatch Experimental
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|123|The Elixir}}
|Bikerdude and Obsttorte
|{{Forumlink|http://forums.thedarkmod.com/topic/19323-fan-mission-the-elixir-by-b1k3rdude-obsttorte-17022018/}} [https://www.youtube.com/watch?v=KfElYZs-FaE Briefing]
|2018-02-17
|112
|Yes
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|122|Volta 2: Cauldron of the Gods}}
|Kingsal
|{{Forumlink|http://forums.thedarkmod.com/topic/19207-volta-ii-cauldron-of-the-gods/}} [https://www.youtube.com/watch?v=SRRCRVFHruc Briefing]
|2017-11-30
|252
|Yes
|[[Fan_Mission_Series#Volta series|Volta]]
|Lost Civilizations
|Undead
|-

|-
!align=left|{{TDM-FM|121|In the Black}}
|VanishedOne
|{{Forumlink|http://forums.thedarkmod.com/topic/19185-fan-mission-in-the-black/}}
|2017-11-18
|103
|No
|
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|120|Accountant 1: Thieves and Heirs}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/19164-fan-mission-the-accountant-1-thieves-and-heirs-by-goldwell-20171108}} [https://www.youtube.com/watch?v=Tk9DtOT4kjc Briefing]
|2017-11-08
|247
|No
|[[Fan_Mission_Series#The Accountant series|The Accountant]]
|Mansion/Estate
|Spiders
|-

|-
!align=left|{{TDM-FM|119|King of the Mountain}}
|Spoonman
|{{Forumlink|http://forums.thedarkmod.com/topic/19105-fan-mission-king-of-the-mountain-by-spoonman-18092017/}}
|2017-09-18
|8.07
|No
|
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|118|Briarwood Manor}}
|NeonStyle
|{{Forumlink|http://forums.thedarkmod.com/topic/18980-fan-mission-briarwood-manor-by-neonsstyle-first-mission-2017-07-11}} [https://www.youtube.com/watch?v=BZnSuLVatYM Trailer] [https://www.youtube.com/watch?v=CPlu8fEzyGM Briefing]
|2017-07-11
|90
|No
|
|Mansion/Estate
|Spider
|-

|-
!align=left|{{TDM-FM|117|A Matter of Hours}}
|Springheel
|{{Forumlink|http://forums.thedarkmod.com/topic/18809-fan-mission-a-matter-of-hours-by-springheel-2842017/}}
|2017-04-28
|13
|No
|[[Fan Mission Series#Corbin series|Corbin]]
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|116|The Ravine}}
|Spoonman
|{{Forumlink|http://forums.thedarkmod.com/topic/18782-fan-mission-the-ravine-by-spoonman-17042017/}}
|2017-04-17
|30.6
|No
|
|Outdoor/Pagan
|Spiders
|-

|-
!align=left|{{TDM-FM|115|The Bakery Job}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/18707-fan-mission-the-bakery-job-by-sotha-20170309/}}
|2017-03-09
|2
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM||Mission 1: A New Job}}
|Springheel
|{{Forumlink|http://forums.thedarkmod.com/topic/18647-tdm-205-official-introductory-missions/}}
|2017-03-14
|13.8
|No
|[[Fan_Mission_Series#Introduction_campaign|Official Campaign]]
|City Missions Inn/Tavern
|
|-

|-
!align=left|{{TDM-FM|114|Coercion}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/18405-fan-mission-coercion-by-sotha-20160927}}
|2016-09-27
|10
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|113|Down by the Riverside}}
|Dragofer
|{{Forumlink|http://forums.thedarkmod.com/topic/18402-fan-mission-down-by-the-riverside-by-dragofer-20160925}}
|2016-09-25
|56
|No
|[[Fan_Mission_Series#Of Brambles and Thorns series|Of Brambles and Thorns]]
|Mansion/Estate Ship Horror
|Horror themes, Undead
|-

|-
!align=left|{{TDM-FM|112|Penny Dreadful 3: Erasing the Trail}}
|Melan and Bikerdude
|{{Forumlink|http://forums.thedarkmod.com/topic/18200-fan-mission-penny-dreadful-3-by-melan-and-bikerdude-20160710}}
|2016-07-09
|200
|No
|[[Fan_Mission_Series#Penny Dreadful series|Penny Dreadful]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|111|Volta 1: Volta and the Stone}}
|Kingsal
|{{Forumlink|http://forums.thedarkmod.com/topic/18087-fan-mission-volta-and-the-stone-by-kingsal-05262016}}
|2016-05-27
|102
|Yes
|[[Fan_Mission_Series#Volta series|Volta]]
|Mansion/Estate City Missions
|
|-

|-
!align=left|{{TDM-FM|110|Full Moon Fever}} (v2.0 2018/02/21)
|Spoonman
|{{Forumlink|http://forums.thedarkmod.com/topic/18066-fan-mission-full-moon-fever-by-spoonman-14052016/}}
|2016-05-14
|21
|No
|
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|109|King of Diamonds}}
|Spooks
|{{Forumlink|http://forums.thedarkmod.com/topic/18064-fan-mission-the-king-of-diamonds-by-spooks-20160513}}
|2016-05-13
|26
|No
|
|City Missions
|Occult themes
|-

|-
!align=left|{{TDM-FM|108|Accountant 2: New in Town}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/18054-fan-mission-the-accountant-2-new-in-town-by-goldwell-20160509/}} [https://www.youtube.com/watch?v=xeuIO_GcYjQ Briefing] [https://www.youtube.com/watch?v=w6e_SJ0_JOM Gameplay trailer]
|2016-05-08
|358
|No
|[[Fan_Mission_Series#The Accountant series|The Accountant]]
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|107|The Smiling Cutpurse}}
|Airship Ballet
|{{Forumlink|http://forums.thedarkmod.com/topic/17850-fan-mission-the-smiling-cutpurse-by-airship-ballet-20160325/}}
|2016-03-25
|87
|No
|
|Mansion/Estate Sewers
|
|-

|-
!align=left|{{TDM-FM|106|Mother Rose}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/17653-fan-mission-mother-rose-by-grayman-20160101/#entry385131/}}
|2016-01-01
|10
|No
|
|Mansion/Estate
|Ghost
|-

|-
!align=left|{{TDM-FM|105|Behind Closed Doors}}
|Bikerdude and the Crucible Team
|{{Forumlink|http://forums.thedarkmod.com/topic/17627-crucible-of-omens-behind-closed-doors-by-bikerdude-the-crucible-team-updated-18122015/}}
|2015-12-19
|359
|Yes
|[[Fan_Mission_Series#Crucible of Omens series|Crucible of Omens]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|103|The Rats Triumphant}}
|Melan
|{{Forumlink|http://forums.thedarkmod.com/topic/17512-fan-mission-the-rats-triumphant-by-melan-20151031/}}
|2015-10-31
|11
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]] (Winner)
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|104|Dead Drunk}}
|Stumpy
|{{Forumlink|http://forums.thedarkmod.com/topic/17511-fan-mission-dead-drunk-by-stumpy-20151030/}}
|2015-10-30
|4
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Tombs, Catacombs & Crypts
|Undead
|-

|-
!align=left|{{TDM-FM|97|Thief's Remorse}}
|Airship Ballet
|{{Forumlink|http://forums.thedarkmod.com/topic/17509-fan-mission-thiefs-remorse-by-airship-ballet-20151030/}}
|2015-10-30
|42
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Tombs, Catacombs & Crypts
|Undead
|-

|-
!align=left|{{TDM-FM|102|Spring Cleaning}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/17510-fan-mission-spring-cleaning-by-goldwell-20151030/}} [https://www.youtube.com/watch?v=JzPpmDK9Fxw Briefing]
|2015-10-30
|45
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Mansion/Estate
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|96|The Golden Skull}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/17497-fan-mission-the-golden-skull-by-sotha-20151024/}}
|2015-10-25
|7
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|101|A House of Locked Secrets}}
|Moonbo
|{{Forumlink|http://forums.thedarkmod.com/topic/17163-fan-mission-a-house-of-locked-secrets-by-gelo-moonbo-fleisher-20150528/}} [https://www.youtube.com/watch?v=f5NuTJEZ8VE Trailer]
|2015-05-29
|195
|No
|[[Fan_Mission_Series#Shadowcursed series|Shadowcursed]]
|Church/Cathedral Mansion/Estate
|Horror themes Undead
|-

|-
!align=left|{{TDM-FM|100|Ulysses 2: Protecting the Flock}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/17162-fan-mission-ulysses-2-protecting-the-flock-by-sotha-20150528/}}
|2015-05-28
|102
|No
|[[Fan_Mission_Series#Ulysses series|Ulysses]]
|Church/Cathedral
|
|-

|-
!align=left|{{TDM-FM|99|Sir Talbot's Collateral}}
|Baal and Bikerdude
|{{Forumlink|http://forums.thedarkmod.com/topic/17093-fan-mission-sir-talbots-collateral-by-baal-bikerdude-15042015/}} [https://www.youtube.com/watch?v=e3rdZfq4Omc Trailer]
|2015-04-15
|60
|Yes
|[[Fan_Mission_Series#Sir Talbot series|Sir Talbot]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|98|Vengeance for a Thief Part 3}}
|Sir Taffsalot
|{{Forumlink|http://forums.thedarkmod.com/topic/16953-the-complete-vengeance-for-a-thief-campaign/}}
|2015-02-16
|25
|No
|[[Fan_Mission_Series#Vengeance for a Thief series|VFAT]]
|Church/Cathedral
|
|-

|-
!align=left|{{TDM-FM|95|Lord Edgar's Bathhouse}}
|Goldwell
|{{Forumlink|1=http://forums.thedarkmod.com/topic/16828-fan-mission-lord-edgars-bathhouse-by-goldwell-27122014/}} [https://www.youtube.com/watch?v=vYSZY7VzFEo Briefing]
|2014-12-27
|71
|No
|Lord Edgar
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|94|Quinn Co.}} (Made into a campaign, 2015/02/04)
|Airship Ballet
|{{Forumlink|1=http://forums.thedarkmod.com/topic/16912-fan-mission-chase-mercantile-by-airship-ballet-20150204/}}
|2014-11-22
|111
|No
|Quinn Co.
|Bank Jobs
|
|-

|-
!align=left|{{TDM-FM|93|Exhumed}}
|Airship Ballet and Kyyrma
|{{Forumlink|1=http://forums.thedarkmod.com/topic/16658-fan-mission-exhumed-by-kyyrma-and-airship-ballet-20141104/}}
|2014-11-04
|24
|No
|[[Fan_Mission_Contests#2014 Halloween Speed-build Contest|HSC 14]]
|Church/Cathedral Horror
|Undead
|-

|-
!align=left|{{TDM-FM|92|Briarwood Cathedral}}
|buck28
|{{Mirrorlink|http://www64.zippyshare.com/v/25705489/file.html}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16644-briarwood-cathedral/}}
|2014-10-29
|7
|No
|[[Fan_Mission_Series#Master thief Corso series|Corso]] [[Fan_Mission_Contests#2014 Halloween Speed-build Contest|HSC 14]]
|Church/Cathedral Horror
|Undead
|-

|-
!align=left|{{TDM-FM|91|One Step Too Far}}
|Dragofer
|{{Mirrorlink|https://www.dropbox.com/s/sfxcap1gfdzf318/onesteptoofar.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16457-fan-mission-one-step-too-far-by-dragofer-20140804/}}
|2014-08-04
|9
|No
|[[Fan_Mission_Series#Of Brambles and Thorns series|Of Brambles and Thorns]]
|Pirate Ship
|
|-

|-
!align=left|{{TDM-FM|90|Lockner Manor}}
|buck28
|{{Mirrorlink|http://www76.zippyshare.com/v/44108372/file.html}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16452-new-mission-lockner-manor/}}
|2014-08-02
|6
|No
|[[Fan_Mission_Series#Master thief Corso series|Corso]]
|Mansion/Estate Inn/Tavern
|
|-

|-
!align=left|{{TDM-FM|89|Ulysses: Genesis}}
|Sotha
|{{Mirrorlink|http://www4.zippyshare.com/v/67195436/file.html}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16428-fan-mission-ulysses-genesis-by-sotha-20140724/}}
|2014-07-24
|98
|No
|[[Fan_Mission_Series#Ulysses series|Ulysses]]
|Mansion/Estate
|Horror theme?
|-

|-
!align=left|{{TDM-FM|88|Penny Dreadful 2: All the way up}}
|Melan and Bikerdude
|{{Mirrorlink|https://mega.co.nz/#!EwoXHZYZ!tE_sKon2h4AWtWPNt9QS3FQClwmXdimhfjIMPcpCQ34}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16387-fan-mission-penny-dreadful-2-by-melan-and-bikerdude-2014078/}} [https://www.youtube.com/watch?v=WmPfCfbeWvg Trailer]
|2014-07-08
|102
|No
|[[Fan_Mission_Series#Penny Dreadful series|Penny Dreadful]]
|Thieves' Highway / Rooftop
|Spiders
|-

|-
!align=left|{{TDM-FM|87|Poets and Peasants}}
|Digi
|{{Mirrorlink|https://drive.google.com/file/d/0B1HHvWAgbWGfTkI0SXFubXZucXM}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16373-fan-mission-poets-peasants-by-digi-62914}}
|2014-06-29
|1
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|85|A Reputation to Uphold}}
|Springheel
|{{Mirrorlink|http://www.mindplaces.com/follow.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16204-fan-mission-a-reputation-to-uphold-by-springheel/}}
|2014-04-18
|25.5
|No
|[[Fan_Mission_Series#Corbin series|Corbin]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|86|Breaking Out the Fence}}
|Kyyrma
|{{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/breakingout.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16091-fan-mission-breaking-out-the-fence-17032014-by-kyyrma/}}
|2014-03-17
|11.6
|No
|[[Fan_Mission_Series#In A Time of Need series|In A Time of Need]]
|City Missions Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|83|Inn Business}} (v.1.48, 2014/03/08)
|RJFerret
|{{Mirrorlink|https://drive.google.com/file/d/0B81T2ZXLPqhTYWVaODRiSExGeGc}} {{Forumlink|1=http://forums.thedarkmod.com/topic/16018-fan-mission-inn-business-by-rjferret-20140303/}}
|2014-03-03
|6
|No
|
|Inn/Tavern City Streets
|
|-

|-
!align=left|{{TDM-FM|82|William Steele 3: Cleighmoor}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/16011-fan-mission-cleighmoor-by-grayman-201431/#entry338349/}}
|2014-03-01
|38
|No
|[[Fan_Mission_Series#William Steele series|William Steele]]
|Sewers Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|81|William Steele 2: Home Again}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/15919-fan-mission-home-again-by-grayman-2014212/page__fromsearch__1}}
|2014-02-12
|26
|No
|[[Fan_Mission_Series#William Steele series|William Steele]]
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|80|The Gatehouse}}
|Bikerdude Goldchocobo
|{{Mirrorlink|http://www.southquarter.com/tdm/fms/gatehouse.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15844-fan-mission-the-gatehouse-by-bikerdude-goldchocobo-20140114/}} [https://www.youtube.com/watch?v=kcIe2Ucojqw Briefing]
|2014-01-29
|100
|No
|Remake of Evilartist's Doom 3 mod
|Castle/Fortress
|Ghosts
|-

|-
!align=left|{{TDM-FM|79|Window of Opportunity}} (v.1.43, 2014/01/01)
|RJFerret
|{{Mirrorlink|https://drive.google.com/file/d/0B81T2ZXLPqhTWTMzQXZtMVFBSG8}} {{Forumlink|1=http://forums.thedarkmod.com/topic/15727-fan-mission-window-of-opportunity-by-rjferret-20140101/}}
|2014-01-01
|7
|No
|
|Outdoor/Caves
|Spiders (not in short mode)
|-

|-
!align=left|{{TDM-FM|78|In A Time Of Need}}
|kyyrma
| {{Mirrorlink|http://www.mediafire.com/download/a97or40t1xrybh3/timeofneed_v1.zip}} {{Forumlink|http://forums.thedarkmod.com/topic/15354-fan-mission-in-a-time-of-need-by-kyyrma-20131112/}}
|2013-11-12
|5.6
|No
|[[Fan_Mission_Series#In A Time of Need series|In A Time of Need]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|76|Requiem}}
|Moonbo
| {{Mirrorlink|http://www.mediafire.com/download/l6o3vvj9y78hu89/requiem.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15101-fan-mission-requiem-by-gelo-moonbo-fleisher-2013106/}}
|2013-10-08
|107.3
|No
|[[Fan_Mission_Series#Shadowcursed series|Shadowcursed]]
|Lost Civilizations Church/Cathedral
|Undead
|-

|-
!align=left|{{TDM-FM|75|Vengeance for a Thief Part 2}}
|Sir Taffsalot
| {{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/vfat2.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15051-fan-mission-vengeance-for-a-thief-part-2-by-sir-taffsalot-06092013/}}
|2013-09-06
|22
|No
|[[Fan_Mission_Series#Vengeance for a Thief series|VFAT]] [[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]]
|Museum Heists
|
|-

|-
!align=left|{{TDM-FM|74|Lords and Legacy}}
|Kvorning
| {{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/lordsnlegacy.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15016-fan-mission-lords-legacy-by-kvorning-20130830/}}
|2013-08-30
|45
|No
|
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|72|Not An Ordinary Guest}}
|Fieldmedic
| {{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/naog.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14965-fan-mission-not-an-ordinary-guest-by-fieldmedic-20130801/}}
|2013-08-01
|79.6
|No
|[[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|71|Penny Dreadful: Grail of Regrets}}
|Melan
| {{Forumlink|http://forums.thedarkmod.com/topic/14952-fan-mission-penny-dreadful-by-melan-20130728/}}
|2013-07-27
|74
|No
|[[Fan_Mission_Series#Penny Dreadful series|Penny Dreadful]]
|Horror
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|70|Solar Escape 1}}
|Tr00pertj
| {{Forumlink|http://forums.thedarkmod.com/topic/14944-fan-mission-solar-escape-1/}}
|2013-07-22
|6
|No
|
|Mansion/Estate Sewers
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|69|The Lich Queen's Demise}}
|Sotha
|{{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/lich_queens_demise.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14826-fan-mission-the-lich-queens-demise-by-sotha-20130520/unread/}}
|2013-05-20
|97.6
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]] [[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]] (Winner)
|Horror
|Undead
|-

|-
!align=left|{{TDM-FM|77|Old Habits Rebuild}}
|Obsttorte
|{{Bloodgate|mc.pk4}} {{Mirrorlink|http://www.mediafire.com/download/u2gwucibh17c45a/oldhabits.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14827-fan-mission-old-habits-rebuild-by-obsttorte-20052013/}}
|2013-05-20
|28.6
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|68|The Builder's Blocks}}
|Jesps
|{{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/builders_blocks.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14592-unusual-gameplay-contest-fm-the-builders-blocks-by-jesps/}}
|2013-03-18
|2.85
|No
|[[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]]
|Experimental
|
|-

|-
!align=left|{{TDM-FM|67|Crystal Grave}} (v.2.0, 2013/02/09)
|ERH+ Bikerdude
|{{Mirrorlink|https://dl.dropbox.com/u/17706561/crystalgravev2.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14510-fan-mission-crystal-grave-v2-by-erh-and-bikerdude-20130209/unread/}}
|2011-11-15
|12.4
|No
|
|Horror
|Undead
|-

|-
!align=left|{{TDM-FM|66|The Builder Roads}}
|Obsttorte
|{{Forumlink|http://forums.thedarkmod.com/topic/14449-fan-mission-the-builder-roads-by-obsttorte-20130119/}}
|2013-01-19
|?
|No
|
|Horror
|Ghosts
|-

|-
!align=left|{{TDM-FM|65|William Steele 1: In the North}}
|grayman
|{{Bloodgate|ws1_north.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14214-fan-mission-in-the-north-by-grayman-20121020/}}
|2012-10-20
|39.8
|No
|[[Fan_Mission_Series#William Steele series|William Steele]]
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|64|Old Habits}}
|Obsttorte
|{{Bloodgate|mc.pk4}} {{Mirrorlink|http://www.mediafire.com/download.php?andes2xnsonssfj}} {{Forumlink|http://forums.thedarkmod.com/topic/14206-fan-mission-old-habits-by-obsttorte-20121019/}}
|2012-10-19
|12.8
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|63|Deceptive Shadows}}
|ShadowHide
|{{Bloodgate|DeceptiveShadows.pk4}} {{Mirrorlink|http://www.sendspace.com/file/jzr9s7}} {{Forumlink|http://forums.thedarkmod.com/topic/14103-fan-mission-deceptive-shadows-by-shadowhide-16sep12/}}
|2012-09-16
|22.4
|No
|
|Outdoor/Pagan
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|62|Vengeance for a Thief: Part 1}}
|Sir Taffsalot
|{{Bloodgate|VFAT1.pk4}} {{Mirrorlink|https://dl.dropbox.com/u/17706561/VFAT1.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14068-fan-mission-vengeance-for-a-thief-part-1-by-sir-taffsalot-06092012/}}
|2012-09-06
|20.9
|No
|[[Fan_Mission_Series#Vengeance for a Thief series|VFAT]]
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|61|The Phrase Book}}
|Sotha
|{{Bloodgate|phrase_book.pk4}} {{Mirrorlink|http://dl.dropbox.com/u/17706561/phrase_book.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13799-fan-mission-the-phrase-book-by-sotha-20120512/}}
|2012-05-11
|24
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|60|In Remembrance of Him}}
|RPGista
|{{Bloodgate|remembrance.pk4}} {{Mirrorlink|http://dl.dropbox.com/u/17706561/remembrance.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13749-fan-mission-in-remembrance-of-him-by-rpgista/}}
|2012-04-22
|27.6
|No
|[[Fan_Mission_Contests#2012_Community_Beginner_Contest|CBC 12]]
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|59|Rightful Property}}
|jysk
|{{Bloodgate|rightful.pk4}} {{Mirrorlink|http://dl.dropbox.com/u/17706561/rightful1.1b.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13711-fan-mission-rightful-property-by-jysk-20120413/}}
|2012-04-12
|22.5
|No
|[[Fan_Mission_Contests#2012_Community_Beginner_Contest|CBC 12]]
|Bank Jobs
|Spiders
|-

|-
!align=left|{{TDM-FM|58|Sneak and Destroy}}
|SeriousToni
|{{Bloodgate|kneipe24.pk4}} {{Mirrorlink|http://minus.com/mVcf61n3G/1f}} {{Forumlink|http://forums.thedarkmod.com/topic/13706-fan-mission-sneak-destroy-by-serioustoni-beginners-contest-2012/}}
|2012-04-11
|158
|No
|[[Fan_Mission_Contests#2012_Community_Beginner_Contest|CBC 12]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|56|House of Theo}}
|Theothesnopp
|{{Bloodgate|houseoftheo.pk4}} {{Mirrorlink|http://www.gamefront.com/files/21053391/houseoftheo__2__2.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13242-fan-mission-house-of-theo/}}
|2011-12-04
|6.2
|No
|
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|53|Dragon's Claw}}
|Bikerdude, Flanders (map assets)
|{{Bloodgate|claw.pk4}}{{Mirrorlink|http://www.gamefront.com/files/20948800/claw.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13181-fan-missiondragons-claw-by-b1k3rdude-31102011/}}
|2011-10-31
|98
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|52|A Night to Remember}} (v2.0, 2018/05/28)
|Fieldmedic
|{{Bloodgate|antr.pk4}} New → {{Forumlink|http://forums.thedarkmod.com/topic/19452-a-night-to-remember/}} Old → {{Forumlink|http://forums.thedarkmod.com/topic/13177-fan-mission-a-night-to-remember-by-fieldmedic-20111030/}}
|2011-10-31
|33
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Mansion/Estate Horror
|Ghosts
|-

|-
!align=left|{{TDM-FM|51|The Creeps}}
|Mortem Desino
|{{Bloodgate|thecreeps.pk4}}{{Mirrorlink|http://www.gamefront.com/files/20939925/thecreeps.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13176-fan-mission-creeps-the-20111030-by-mortem-desino/}}
|2011-10-30
|61
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Horror
|Ghosts
|-

|-
!align=left|{{TDM-FM|50|House in Blackbog Hollow}}
|Stumpy
|{{Bloodgate|blackbog.pk4}}{{Mirrorlink|http://www.bookofages.co.uk/doom3/mods/blackbog.html}} {{Forumlink|http://forums.thedarkmod.com/topic/13172-fan-mission-house-in-blackbog-hollow-by-stumpy-20111028/}}
|2011-10-28
|12
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Horror
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|49|Let Sleeping Thieves Lie}}
|Sir Taffsalot, Bikerdude
|{{Bloodgate|lstl.pk4}}{{Mirrorlink|http://www.mediafire.com/?zkd1jn4lpwgioh9}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/13153-let-sleeping-thieves-lie-by-sir-taffsalot-bikerdude-20102011/}}
|2011-10-20
|13
|No
|
|Tombs, Catacombs & Crypts
|Undead
|-

|-
!align=left|{{TDM-FM|48|Samhain Night}}
|PranQster
|{{Bloodgate|samhain.pk4}}{{Mirrorlink|http://jdchoate.mcn.org/games/darkmod/samhain.zip}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/13127-fan-mission-samhain-night-on-bone-hill-by-pranqster-20111009/}}
|2011-10-09
|10
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Horror
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|47|A Score to Settle}}
|Springheel
|{{Bloodgate|score_to_settle.pk4}}{{Mirrorlink|http://www.mediafire.com/?f3o7hm4h4ew7o3l}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12894-fan-mission-%2348-a-score-to-settle-by-springheel-20110701/}}
|2011-07-01
|135
|No
|[[Fan_Mission_Series#Corbin series|Corbin]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|46|Siege Shop}} (v3.0 2013/10/10)
|PranQster and Lowenz
|{{Bloodgate|siegeshop.pk4}}{{Mirrorlink|http://jdchoate.mcn.org/games/darkmod/siegeshop.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12874-fan-mission-the-siege-shop-by-pranqster-20110626/}}
|2011-06-26
|20.51
|No
|
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|44|Alberic's Curse}}
|Bikerdude
|{{Bloodgate|alberic.pk4}} {{Mirrorlink|http://www.gamefront.com/files/20459738/alberic.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12850-fan-mission-alberics-curse-by-b1k3rdude-20062011/}}
|2011-06-20
|29
|No
|[[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]] (Winner) T2 FM homage
|Church/Cathedral
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|45|Reap As You Sow}}
|Fieldmedic
|{{Bloodgate|reap.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12849-fan-mission-reap-as-you-sow-by-fieldmedic-20110619/}}
|2011-06-19
|52
|No
|[[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|Outdoor/Daylight Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|43|Rake Off}}
|Jesps
|{{Bloodgate|rake_off.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12846-fm-rake-off-19-06-2011/}}
|2011-06-19
|8
|No
|[[Fan_Mission_Series#Selis Woderose series|Selis Woderose]] [[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|42|Winter Harvest}} (v2.0 2011/07/24 with Bikerdude)
|ShadowHide
|{{Bloodgate|winterharvest.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12690-seasons-contest-entry-winter-harvest-by-shadowhide/}}
|2011-05-08
|10
|No
|[[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|Outdoor/Pagan
|Spiders
|-

|-
!align=left|{{TDM-FM|41|Fiasco at Fauchard Street}}
|Melan
|{{Bloodgate|fauchard.pk4}} {{Mirrorlink|https://rapidshare.com/files/460141132/fauchard.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12655-fan-mission-fiasco-at-fauchard-street-by-melan-20110501//}}
|2011-05-01
|62
|No
|[[Fan_Mission_Series#Sir Talbot series|Sir Talbot]]
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|40|Mandrasola}}
|Sotha
|{{Bloodgate|mandrasola.pk4}} {{Mirrorlink|http://www.mediafire.com/?2ox2nbhh796ne71}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12575-fan-mission-mandrasola-by-sotha-20110410/}}
|2011-04-10
|10
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]] [[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|City Missions
|Undead
|-

|-
!align=left|[http://www.southquarter.com/tdm/fms/yantdm1.1.pk4 Q4 Conversion: Yan's Test]
|Bikerdude
|{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12506-fan-mission-q4-map-conversion-yantdm1-280311/}}
|2011-03-28
|28
|No
|
|
|
|-

|-
!align=left|{{TDM-FM|38|The Transaction}}
|Sotha
|{{Bloodgate|transaction.pk4}} {{Mirrorlink|http://www.mediafire.com/?ux7mx79wumnvcb6}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12408-fan-mission-the-transaction-by-sotha-20110304/}}
|2011-03-04
|10
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|13|Return to the City}} (v3.0 2015/01/03)
|Melan, Bikerdude
|{{Bloodgate|ReturnToTheCityV2.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10509-fan-mission-return-to-the-city-by-melan-20100110/}} {{Forumlink|1=http://www.ttlg.com/forums/showthread.php?t=130519/}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12390-fan-mission-return-to-the-city-v2-01032011/}}
|2010-01-10
|26
|No
|[[Fan_Mission_Series#Sir Talbot series|Sir Talbot]] [[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]] (Winner)
|City Missions
|
|-

|-
!align=left|{{TDM-FM|39|Lockdown}}
|GameDevGoro Bikerdude Fidcal
|{{Bloodgate|lockdown1_2_1.pk4}} {{Mirrorlink|http://www.fidcal.com/darkuser/missions/lockdown1_2_1.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12064-fm-lockdown-part-1-by-gamedevgoro-and-bikerdude-20101224/}}
|2010-12-25
|3
|No
|Lockdown 1
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|37|Flakebridge Monastery}}
|Jesps
|{{Bloodgate|flakebridge.pk4}} {{Mirrorlink|http://www.file-upload.net/download-3024426/flakebridge.pk4.html}} {{Mirrorlink|http://rapidshare.com/files/434997519/flakebridge.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11991-fm-flakebridge-monastery-by-jesps/}}
|2010-12-05
|16
|No
|[[Fan_Mission_Series#Selis Woderose series|Selis Woderose]]
|Church/Cathedral
|Undead
|-

|-
!align=left|{{TDM-FM|36|Knighton Manor, The}}
|Sotha
|{{Bloodgate|knighton_manor.pk4}} {{Mirrorlink|http://www.mediafire.com/?xrdts3j4t2qxre2}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11898-fan-mission-the-knighton-manor-by-sotha-20101109/page__view__getnewpost}}
|2010-11-09
|21
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|35|St Albans Cathedral}} (v2.0 2014/06/11)
|Bikerdude
|{{Bloodgate|stac160.pk4}} [[http://www.bloodgate.com/fms/stac142.pk4 Classic]] {{Mirrorlink|http://www.filefront.com/17464439/stac141.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16343-fan-mission-st-albans-cathedral-v20-11062014/}} {{Loot|FM:TDM_St_Alban's_Cathedral_-_Bikerdude}}
|2010-11-01
|67
|No
|[[Fan_Mission_Series#St Alban series|St Alban]]
|Church/Cathedral
|Undead
|-

|-
!align=left|{{TDM-FM|33|Swing}}
|Komag
|{{Bloodgate|swing_v1.2.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11660-vertigo-contest-entry-swing-by-komag-20100825/}} {{Loot|FM:TDM_Swing_-_Komag}}
|2010-08-25
|3
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Platforming/Jumping Experimental
|
|-

|-
!align=left|{{TDM-FM|32|The Caduceus of St. Alban}} (v.1.5.5 2010/08/26)
|Bikerdude
|{{bloodgate|stalban.pk4}} {{Mirrorlink|http://www.filefront.com/17237609/stalban.pk4/}}{{Forumlink|http://forums.thedarkmod.com/topic/11644-the-caduceus-of-st-alban-vertical-fm-contest-entry-aug-8th-2010/}}
|2010-08-23
|11.3
|No
|[[Fan_Mission_Series#St Alban series|St Alban]] [[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Church/Cathedral
|Spiders
|-

|-
!align=left|{{TDM-FM|30|Somewhere Above the City}} (v1.1 2010/08/27)
|grayman
|{{Bloodgate|somewhere1.1.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11619-vertical-contest-mission-somewhere-above-the-city-by-grayman-aug-20-2010/}} {{Loot|FM:TDM_Somewhere_Above_the_City_-_grayman}}
|2010-08-20
|11
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Tombs, Catacombs & Crypts
|
|-

|-
!align=left|{{TDM-FM|29|Betrayal}} (v.1.1, 2010/09/01)
|Fieldmedic
|{{Bloodgate|betrayal.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11605-betrayal-by-fieldmedic-20100817-summer-fm-vertical-contest-entry/}} {{Loot|FM:TDM_Awaiting_the_Storm_-_HappyCheeze}}
|2010-08-17
|12
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Horror
|Undead
|-

|-
!align=left|{{TDM-FM|31|Rift, The}}
|Baddcog
|{{Bloodgate|rift.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11599-vert-contest-mission-the-rift-by-baddcog-aug-15-2010/}}
|2010-08-15
|10
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Lost Civilizations
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|34|Illusionist's Tower}}
|stumpy
|{{Bloodgate|holetower.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11541-illusionists-tower-by-stumpy-201085-summer-fm-vertical-contest-entry}} {{Forumlink|1=http://www.bookofages.co.uk/doom3/mods/holetower.html}} {{Loot|FM:TDM_Illusionist%27s_Tower_-_stumpy}}
|2010-08-05
|9
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Horror Experimental
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|28|Mad's Mountain}}
|Jesps
|{{Bloodgate|madmountain.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11510-fan-mission-mads-mountain-by-jesps-20100731}} {{Loot|FM:TDM_Lord_Dufford%27s_-_stumpy}}
|2010-07-31
|2
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Outdoor/Caves
|
|-

|-
!align=left|{{TDM-FM|27|Glenham Tower, The}}
|Sotha
|{{Bloodgate|glenham_tower.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11423-fan-mission-the-glenham-tower-by-sotha-20100717}}
|2010-07-17
|5
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]] [[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]] (Winner)
|Castle/Fortress Horror
|Undead
|-

|-
!align=left|{{TDM-FM|25|Pandora's Box}}
|Jesps, Fidcal
|{{Bloodgate|pandoras_box.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11381-fan-mission-pandoras-box-by-jesps20100711}} {{Loot|FM:TDM_Pandora%27s_Box_-_Jesps}}
|2010-07-11
|7
|No
|
|Pirate Ship Experimental
|
|-

|-
!align=left|{{TDM-FM|23|Beleaguered Fence, The}}
|Sotha
|{{Bloodgate|beleaguered_fence.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11298-fan-mission-the-beleaguered-fence-by-sotha-20100623}} {{Loot|FM:TDM_The_Beleaguered_Fence_-_Sotha}}
|2010-06-23
|11
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|22|Special Delivery, A}}
|Silencium18
|{{Bloodgate|delivery.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11247-fan-mission-a-special-delivery-by-silencium1820100612}} {{Loot|FM:TDM_A_Special_Delivery_-_Silencium18}}
|2010-06-12
|2
|No
|
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|21|Alchemist, The}} (2010/06/04)
|Sotha, Fidcal
|{{Bloodgate|alchemist.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11170-fan-mission-the-alchemist-by-sotha-fidcal20100601}} {{Loot|FM:TDM_The_Alchemist_-_Sotha_%26_Fidcal}}
|2010-06-01
|27
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|20|Awaiting The Storm}}
|HappyCheeze
|{{Bloodgate|storm.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11095-fm-awaiting-the-storm-by-happycheeze-20200522}} {{Loot|FM:TDM_Awaiting_the_Storm_-_HappyCheeze}}
|2010-05-22
|4
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|19|Sound Alert & Blackjack Trainer}}
|Dark Mod Team
|
|2010-05-14
|0.2
|No
|
|Training
|
|-

|-
!align=left|{{TDM-FM|18|No Honor Among Thieves}} (v.3.0, 2015/05/30)
|Goldchocobo, RailGun, Mortem Desino, Bikerdude
|{{Mirrorlink|http://tinyurl.com/2a9mdcs}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10993-fan-mission-no-honor-among-thieves-20100429}} {{Loot|FM:TDM_No_Honor_Among_Thieves_-_Goldchocobo}}
|2010-04-29
|203
|No
|
|Church/Cathedral; City Missions; Outdoor/Pagan, Mansion/Estate
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|17|Heart of Lone Salvation, The}} (v.2.0, 2014/04/12)
|Fidcal, Baddcog, Bikerdude
|{{Bloodgate|heart.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/topic/10878-fan-mission-the-heart-of-lone-salvation-by-fidcal-baddcog-bikerdude-20100402/?p=213506}} {{Walkthrough|FM:TDM_The_Heart_of_Lone_Salvation_-_Fidcal_%26_Baddcog_%26_Bikerdude}} {{loot|FM:TDM_The_Heart_of_Lone_Salvation_-_Fidcal_%26_Baddcog_%26_Bikerdude}}
|2010-04-02
|41
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|City Missions
|Spiders
|-

|-
!align=left|{{TDM-FM|73|Lord Dufford's}}
|stumpy
|{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10868-fan-mission-lord-duffords-20100331}} {{Loot|FM:TDM_Lord_Dufford%27s_-_stumpy}}
|2010-03-31
|22
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|16|Builder's Influence, The}} (2010/03/23)
|Railgun, Springheel
|{{Bloodgate|builders_influence.pk4}} {{Mirrorlink|http://www.fidcal.com/darkuser/missions/builders_influence.pk4}}{{Forumlink|http://forums.thedarkmod.com/index.php?/topic/10811-fan-mission-the-builders-influence-20100320/}} {{Loot|FM:TDM_The_Builders_Influence_-_Railgun%26Springheel}}
|2010-03-20
|15
|No
|[[Fan_Mission_Series#Corbin series|Corbin]]
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|14|Business as Usual}} (v2.0 2011/09/24)
|Bikerdude
|{{Bloodgate|business.pk4}}{{Mirrorlink|1=http://rapidshare.com/files/335299431/business.pk4.html}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10533-fan-mission-business-as-usual-by-b1k3rdude-14012010-christmas-fm-contest-entry/page__view__findpost__p__207055}}
|2010-01-14
|4
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Sewers
|
|-

|-
!align=left|{{TDM-FM|12|Sons of Baltona 1, The}}
|Carnage
|{{Bloodgate|sons_of_baltona_1.pk4}} {{Mirrorlink|1=http://www.mediafire.com/?m4ywobjodm0}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10498-fan-mission-the-sons-of-baltona-1-by-carnage-20100109}}
|2010-01-09
|3
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]] / Baltona 1
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|11|Living Expenses}}
|Sonosuke
|{{Bloodgate|living_expenses.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10451-fm-living-expenses-by-sonosuke-2-jan-10/page__view__findpost__p__205386}}
|2010-01-02
|6
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|10|Trapped!}}
|RailGun
|{{Bloodgate|trapped.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10442-fm-trapped-by-railgun-dec-30/page__view__findpost__p__205092}}
|2009-12-30
|6
|No
|
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|8|Parcel, The}}
|Xonze
|{{Bloodgate|parcel.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10404-fm-the-parcel-by-xonze-dec-24/page__view__findpost__p__204459}}
|2009-12-24
|7
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|9|Too Late}}
|Nielsen74
|{{Bloodgate|too_late.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10400-fm-too-late-by-nielsen74-24-dec-09/page__view__findpost__p__204396}}
|2009-12-24
|4
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|7|Thieves}}
|Silencium, RailGun, Fidcal
|{{Bloodgate|thieves.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10286-fm-the-thieves-nov-2509/}}
|2009-11-26
|9
|No [https://www.moddb.com/mods/the-dark-mod/addons/unofficial-thieves-efx Unofficial EFX Build]
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|6|Patently Dangerous}} (v.2.0, 2013/10/08)
|demagogue
|{{Bloodgate|patently_dangerous.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10125-fm-patently-dangerous-oct3109/page__view__findpost__p__199324/}}
|2009-10-31
|24
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|5|Dark Mod Training Mission, The}}
|TDM Team
|{{Bloodgate|training_mission.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9932-fm-training-mission-17-oct-09/}}
|2009-10-17
|6
|No
|[[Fan_Mission_Series#Introduction_campaign|Official Campaign]]
|Training Platforming/Jumping
|
|-

|-
!align=left|{{TDM-FM|2|Crown of Penitence, The}}
|Jesps
|{{Bloodgate|crow_of_penitence.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9934-fm-crown-of-penitence-by-jesps-17-oct-09/}}
|2009-10-16
|12
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|3|Chalice of Kings, The}} (v.2.0, 2015/09/24) (Bikerdude and Xarg)
|Fidcal
|{{Bloodgate|chalice.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9935-fm-chalice-of-kings-by-fidcal-17-oct-09/}} {{Loot|FM:TDM_Chalice_of_Kings_-_Fidcal}}
|2009-10-15
|3
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|1|Outpost, The}}
|angua, greebo
|{{Bloodgate|outpost.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9937-fm-the-outpost-by-angua-greebo-17-oct-09/}}
|2008-12-23
|2
|No
|
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|15|Mission 2: Tears of Saint Lucia, The}} (v.3.0, 2017/02/14)
|TDM Team
|{{Bloodgate|saintlucia.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10579-fan-mission-the-tears-of-st-lucia-20081021/page__view__findpost__p__207972}} {{Loot|FM:TDM_The_Tears_of_Saint_Lucia_-_jdude}} [https://www.youtube.com/watch?v=yrGxoi3LSGg Briefing]
|2008-10-21
|20.3
|No
|[[Fan_Mission_Series#Introduction_campaign|Official Campaign]]
|Church/Cathedral
|Spiders
|-

|-
!align=left|{{TDM-FM|57|Closemouthed Shadows}} (v.2.0, 2012/01/15)
|LordSavage, Bikerdude
|{{Bloodgate|closemouthed_shadows.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/topic/13383-fan-mission-closemouthed-shadows-2008-reworked-for-tdm-107-20120115/}}
|2008-09-21
|2
|No
|Closemouthed Shadows 1
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|24|Thief's Den}} (v.2.0, 2010/07/04)
|Fidcal, greebo
|{{Bloodgate|thiefs_den.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11347-fan-mission-thiefs-den-re-release-by-fidcal20100704}} {{Walkthrough|FM:TDM_Thief's_Den_-_Fidcal}} {{Loot|FM:TDM_Thief%27s_Den_-_Fidcal}}
|2008-01-18
|3
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|City Missions
|
|}

To see a speculative list of Upcoming Fan Missions, please visit: [[Upcoming Fan Missions]]

== Table notes ==

'''Links Key'''
{|class="wikitable" border=1 style="border-collapse: collapse;" cellspacing=0 cellpadding=2
|-
|[http://wik.thedarkmod.com/images/b/be/Icon_forum.png http://wiki.thedarkmod.com/images/b/be/Icon_forum.png]
|Link to discussion in Forums
|-
|{{Mirrorlink|}}
|Misc. download mirror
|-
|{{Bloodgate|}}
|Bloodgate download mirror
|-
|{{Loot|}}
|Loot list
|-
|{{Walkthrough|}}
|Walkthrough
|}

----

'''Mission Type Key'''

''Bear in mind that individual FMs can have combinations of two or three of these overarching genres/themes, rather than just a single one.''

{|class="wikitable" border=1 style="border-collapse: collapse;" cellspacing=0 cellpadding=2
|-
|'''''Bank Jobs'''''
|Fan mission involving a heist or other thievy action inside a local banking institution. Will often contain the outsmarting of security systems, gaining access to a safe and cracking its code.
|-
|'''''Castle/Fortress'''''
|Fan mission involving a heist or other thievy action inside or outside a castle or fortress, either one that serves as a military garrison, or as someone's private residence. Frequently involves background characters from the nobility.
|-
|'''''City Missions'''''
|Fan mission that is set mainly in the streets and public spaces of an urban area, such as a town or city. Though the player is most often out on the streets, these missions tend to also involve some degree of exploration and infiltration into private and public buildings alike.
|-
|'''''Church/Cathedral'''''
|Fan mission set in and around religious buildings and institutions, such as churches, monasteries, cathedrals, church bureaus, church workshops, etc. Frequently involves [[Clergy/Builder_Characters|ecclesiastical characters]] from the TDM setting's [[Builders|Builder Church]].
|-
|'''''Experimental'''''
|Fan mission which involves some creative design or gameplay element that isn't typical for the vast majority of TDM missions. FMs set in highly unusual environments, or with a puzzle-like nature, can fit under this label.
|-
|'''''Inn/Tavern'''''
|Fan mission set mostly in and around an inn, tavern or shanty. Usually focused on robbing some rich guest, acquiring an item stored by the guest at the inn, or gathering intel at the inn.
|-
|'''''Jail/Prison'''''
|Fan mission involving an escape from a prison (by the imprisoned player character), infiltration of a prison to gather intel from inmates or help an inmate escape the prison, etc.
|-
|'''''Lost Civilizations'''''
|Fan mission focused on the exploration of ancient ruins, whether above ground or in deep subterranean caverns. Can often overlap with the ''Horror'' or ''Tombs, Catacombs & Crypts'' type of mission, but not necessarily.
|-
|'''''Horror'''''
|Fan mission with an overt horror theme. Depending on the author's approach and intentions, it can focus on psychological horror, or horror based on danger from supernatural threats, or varying combinations of both.
|-
|'''''Mansion/Estate'''''
|Fan mission involving a heist or other thievy action inside someone's private residence (a fancy house, a manor house) and its surrounding grounds. Frequently involves background characters from the nobility or the more affluent townsmen or citizens.
|-
|'''''Museum Heists'''''
|Fan mission focusing on a heist in a museum, art gallery or other institution storing priceless artefacts, artworks, gemstone collections, etc.
|-
|'''''Outdoor/Caves'''''
|Fan mission set in a mostly natural outdoor environment, but involving the exploration of natural caves and caverns.
|-
|'''''Outdoor/Daylight'''''
|Fan mission set in a mostly outdoor environment, during the daytime (in contrast to the usual TDM missions, set at night time or early dusk).
|-
|'''''Outdoor/Pagan'''''
|Fan mission set in a mostly natural outdoor environment, involving some presence of [[Pagans|pagan tribes]] from TDM's setting. Perhaps even pagan camps and settlements.
|-
|'''''Pirate'''''
|Fan mission involving the presence of characters engaging in piracy or smuggling, and various related piratical themes. Can overlap with the ''Ship'' type of mission, but not necessarily.
|-
|'''''Platforming/Jumping'''''
|Fan mission focusing on testing the player's movement, jumping and climbing skills, with or without equipment.
|-
|'''''Sewers'''''
|Fan mission which involves the use of the city sewers or others sewers in some way, often as a stealthy means of entry or escape.
|-
|'''''Ship'''''
|Fan mission which takes place aboard a vessel, in port or at sea, or otherwise involves ships to a great degree. Can overlap with the ''Pirate'' type of mission, but not necessarily.
|-
|'''''Thieves' Highway / Rooftop'''''
|Fan mission involving a lot of movement and travel on the rooftops of a town or city (colloquially "The Thieves' Highway").
|-
|'''''Tombs, Catacombs & Crypts'''''
|Fan mission involving the exploration of old tombs, catacombs and crypts, often for the purposes of treasure and artefact hunting. Can often overlap with the ''Horror'' or ''Lost Civilizations'' type of mission, but not necessarily.
|-
|'''''Training'''''
|Fan mission label that is unique to the official Training Mission, an open-ended tutorial mission where players can practice and test their TDM gameplay skills at their own leisure, and to the smaller blackjacking-trainer FM, which focuses on practicing NPC knockouts by the player.
|-
|'''''Warehouse'''''
|Fan mission which takes place in and around a warehouse, usually in some industrial area of a city, or at a port.
|}

----

'''Contest Key'''

GCC 09: [[Fan_Mission_Contests#2009 Grand Christmas Contest|Grand Christmas Contest 2009]]

SVC 10: [[Fan_Mission_Contests#2010 Summer Vertical Contest|Summer Vertical Contest 2010]]

CSC 11: [[Fan_Mission_Contests#2011 Community Seasons Contest|Community Seasons Contest 2011]]

HSC 11: [[Fan_Mission_Contests#2011 Halloween Speed-build Contest|Halloween Speed-Build Contest 2011]]

CBC 12: [[Fan_Mission_Contests#2012 Community Beginner Contest|Community Beginner Contest 2012]]

CUC 13: [[Fan_Mission_Contests#2013 Community Unusual Contest|Community Unusual Contest 2013]]

HSC 14: [[Fan_Mission_Contests#2014 Halloween Speed-build Contest|Halloween Speed-Build Contest 2014]]

HSC 15: [[Fan_Mission_Contests#2015 Halloween Speed-build Contest|Halloween Speed-Build Contest 2015]]

----

== Editing this table ==
* Please only include playable missions that are fully released, not those currently in development or testing. Tutorials, demos, prefabs, etc. should be listed elsewhere.
* A mission title may be listed in plain text as a record of release, or preferably a link to an information page or primary direct download.
* List by release date descending (newest at the top).
* If a fan mission only has a single mirror/host please consider adding additional mirrors.

== See also ==
* [[Fan Mission Series]] - An overview of all currently known series or campaigns of fan missions interconnected by their stories or characters. There are already plenty in TDM, and have been since its early days as an expandable game.
* [[Mission recommendation discussions]] - An overview of past discussions on what FMs the community recommends to players looking for various challenges (difficulty, size, theme, setting, objectives, etc.).
* [[Fan Mission Contests]] - An overview of past and present contests in Fan Mission creation, by members of the TDM community.
* [[Upcoming Fan Missions]] - An overview of Fan Missions in development or tentatively planned. (''Do not'' edit the overview.)

{{general|sort=Fan Missions}}
[[Category:Fan Missions]]
[[Category:Official FMs| ]]

Fan Missions for The Dark Mod

2019-09-03T18:22:08Z

VanishedOne: From memory, there's a zombie in a glass tank, so I included the undead tag even though it can't reach the player.

__NOTOC__
{{infobox|<center>'''Big Ugly Disclaimer:'''</center> '''The Dark Mod''' team does not necessarily support or endorse content listed here, and only hosts missions listed on the [http://www.thedarkmod.com/ official TDM website]. This is a community maintained list, and an ongoing work in progress. Most of the mirror links in this list are dead or are for missions that are not 2.0 compliant. Mission entries which are suspected to violate copyright must be text-only, and cannot contain links. Report and/or remove links found in violation of this rule.}}

* For details about editing this table, see [[#Editing_this_table|below]].
* For details about how to install Fan Missions please visit: [[Installing and Running Fan Missions]]
* To sort by a different criterion, click the [[Image:Sort none.gif]] icon in the relevant column header.

{|class="wikitable sortable" border=1 style="border-collapse: collapse;" cellspacing=0 cellpadding=2 width=100%
|-
!bgcolor=#d0d0e0 width="21%"|Fan Mission Title
!bgcolor=#d0d0e0 width="11%"|Author(s)
!bgcolor=#d0d0e0 width="4%" class="unsortable"|Links
!bgcolor=#d0d0e0 width="5%"|First Release
!bgcolor=#d0d0e0 width="2%"|Size (MB)
!bgcolor=#d0d0e0 width="3%"|EFX Reverb
!bgcolor=#d0d0e0 width="10%"|Series
!bgcolor=#d0d0e0 width="13%"|Mission Type
!bgcolor=#d0d0e0 width="6%"|Spiders and Undead
|-



|-
!align=left|{{TDM-FM|138|Hidden Hands: Vitalic Fever}}
|JackFarmer
|{{Forumlink|http://forums.thedarkmod.com/index.php?/topic/20051-hidden-hands-vitalic-fever-20072019}}
|2019-07-20
|269
|Yes
|Hidden Hands 2
|City Missions
|Spiders, undead
|-

|-
!align=left|{{TDM-FM|137|Chronicles of Skulduggery 2: Pearls and Swine}}
|Bienie
|{{Forumlink|http://forums.thedarkmod.com/topic/19975-fan-mission-chronicles-of-skulduggery-2-a-precarious-position-20190504/}}
|2019-05-04
|14.5
|Yes
|[[Fan_Mission_Series#Chronicles_of_Skulduggery_series|Chronicles of Skulduggery]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|136|William Steele 5: Commerce Bank}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19957-fan-mission-commerce-bank-by-grayman-2019410/}}
|2019-04-10
|30
|Yes
|[[Fan_Mission_Series#William_Steele_series|William Steele]]
|Bank Jobs
|
|-

|-
!align=left|{{TDM-FM|135|Marsh of Rahena}}
|ERH+
|{{Forumlink|http://forums.thedarkmod.com/topic/19951-fan-mission-marsh-of-rahena-by-erh-201945}}
|2019-04-05
|60.3
|Yes
|
|Castle/Fortress, Horror
|Undead, Spiders, Horror Themes
|-

|-
!align=left|{{TDM-FM|134|Shadows of Northdale ACT 2}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/19936-fan-mission-shadows-of-northdale-act-ii-by-goldwell-20190320/}} [https://www.youtube.com/watch?v=KO-eIOX9nqI Briefing]
|2019-03-20
|417
|Yes
|[[Fan_Mission_Series#Shadows of Northdale series|Shadows of Northdale]]
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|133|Cleaning Up the Neighbourhood}}
|some1stoleit and Bikerdude
|{{Forumlink|http://forums.thedarkmod.com/topic/19898-fan-mission-cleaning-up-the-neighbourhood-by-some1stoleitbikerdude-20190219/}}
|2019-02-18
|34.3
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|132|Hidden Hands: Initiation}}
|JackFarmer
|{{Forumlink|http://forums.thedarkmod.com/topic/19796-hidden-hands-initiation-27122018/}}
|2018-12-27
|92.5
|Yes
|
|Mansion/Estate Ship
|Spiders, Extra-natural entities
|-

|-
!align=left|{{TDM-FM|131|The Night of Reluctant Benefaction}}
|Bienie
|{{Forumlink|http://forums.thedarkmod.com/topic/19787-fan-mission-the-night-of-reluctant-benefaction/}}
|2018-12-24
|11.9
|Yes
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|130|Mission of Mercy}}
|joebarnin
|{{Forumlink|http://forums.thedarkmod.com/topic/19642-fan-mission-mission-of-mercy-by-joebarnin-20180914/}}
|2018-09-14
|10.1
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|129|William Steele 4: The Warrens}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19618-fan-mission-the-warrens-by-grayman-201891/}}
|2018-09-01
|53
|Yes
|[[Fan_Mission_Series#William_Steele_series|William Steele]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|128|Braeden Church}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19533-fan-mission-braeden-church-by-grayman-201871/}}
|2018-07-01
|24
|No
|
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|127|Chronicles of Skulduggery: Pearls and Swine}}
|Bienie
|{{Forumlink|http://forums.thedarkmod.com/topic/19439-chronicles-of-skulduggery-pearls-and-swine/}}
|2018-05-25
|23
|Yes
|[[Fan_Mission_Series#Chronicles_of_Skulduggery_series|Chronicles of Skulduggery]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|126|Shadows of Northdale ACT I}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/19368-fan-mission-shadows-of-northdale-act-i-by-goldwell-20180323/}} [https://www.youtube.com/watch?v=p4nP3lYd6wg Briefing]
|2018-03-23
|295
|Custom (not EFX)
|[[Fan_Mission_Series#Shadows of Northdale series|Shadows of Northdale]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|125|Sir Taffsalot's Sword}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/19361-fan-mission-sir-taffsalots-sword-by-grayman-2018318/}}
|2018-03-17
|11.3
|No
|
|Mansion/Estate In memoriam of Gary (Sir Taffsalot) {{Forumlink|http://forums.thedarkmod.com/topic/19306-sad-news-we-lost-one-of-our-own-sir-taffsalot/}}
|
|-

|-
!align=left|{{TDM-FM|124|The Arena}}
|ERH+
|{{Forumlink|http://forums.thedarkmod.com/topic/19350-fan-mission-the-arena-by-erh/}}
|2018-03-12
|3
|No
|
|Arena Deathmatch Experimental
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|123|The Elixir}}
|Bikerdude and Obsttorte
|{{Forumlink|http://forums.thedarkmod.com/topic/19323-fan-mission-the-elixir-by-b1k3rdude-obsttorte-17022018/}} [https://www.youtube.com/watch?v=KfElYZs-FaE Briefing]
|2018-02-17
|112
|Yes
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|122|Volta 2: Cauldron of the Gods}}
|Kingsal
|{{Forumlink|http://forums.thedarkmod.com/topic/19207-volta-ii-cauldron-of-the-gods/}} [https://www.youtube.com/watch?v=SRRCRVFHruc Briefing]
|2017-11-30
|252
|Yes
|[[Fan_Mission_Series#Volta series|Volta]]
|Lost Civilizations
|Undead
|-

|-
!align=left|{{TDM-FM|121|In the Black}}
|VanishedOne
|{{Forumlink|http://forums.thedarkmod.com/topic/19185-fan-mission-in-the-black/}}
|2017-11-18
|103
|No
|
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|120|Accountant 1: Thieves and Heirs}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/19164-fan-mission-the-accountant-1-thieves-and-heirs-by-goldwell-20171108}} [https://www.youtube.com/watch?v=Tk9DtOT4kjc Briefing]
|2017-11-08
|247
|No
|[[Fan_Mission_Series#The Accountant series|The Accountant]]
|Mansion/Estate
|Spiders
|-

|-
!align=left|{{TDM-FM|119|King of the Mountain}}
|Spoonman
|{{Forumlink|http://forums.thedarkmod.com/topic/19105-fan-mission-king-of-the-mountain-by-spoonman-18092017/}}
|2017-09-18
|8.07
|No
|
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|118|Briarwood Manor}}
|NeonStyle
|{{Forumlink|http://forums.thedarkmod.com/topic/18980-fan-mission-briarwood-manor-by-neonsstyle-first-mission-2017-07-11}} [https://www.youtube.com/watch?v=BZnSuLVatYM Trailer] [https://www.youtube.com/watch?v=CPlu8fEzyGM Briefing]
|2017-07-11
|90
|No
|
|Mansion/Estate
|Spider
|-

|-
!align=left|{{TDM-FM|117|A Matter of Hours}}
|Springheel
|{{Forumlink|http://forums.thedarkmod.com/topic/18809-fan-mission-a-matter-of-hours-by-springheel-2842017/}}
|2017-04-28
|13
|No
|[[Fan Mission Series#Corbin series|Corbin]]
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|116|The Ravine}}
|Spoonman
|{{Forumlink|http://forums.thedarkmod.com/topic/18782-fan-mission-the-ravine-by-spoonman-17042017/}}
|2017-04-17
|30.6
|No
|
|Outdoor/Pagan
|Spiders
|-

|-
!align=left|{{TDM-FM|115|The Bakery Job}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/18707-fan-mission-the-bakery-job-by-sotha-20170309/}}
|2017-03-09
|2
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM||Mission 1: A New Job}}
|Springheel
|{{Forumlink|http://forums.thedarkmod.com/topic/18647-tdm-205-official-introductory-missions/}}
|2017-03-14
|13.8
|No
|[[Fan_Mission_Series#Introduction_campaign|Official Campaign]]
|City Missions Inn/Tavern
|
|-

|-
!align=left|{{TDM-FM|114|Coercion}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/18405-fan-mission-coercion-by-sotha-20160927}}
|2016-09-27
|10
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|113|Down by the Riverside}}
|Dragofer
|{{Forumlink|http://forums.thedarkmod.com/topic/18402-fan-mission-down-by-the-riverside-by-dragofer-20160925}}
|2016-09-25
|56
|No
|[[Fan_Mission_Series#Of Brambles and Thorns series|Of Brambles and Thorns]]
|Mansion/Estate Ship Horror
|Horror themes, Undead
|-

|-
!align=left|{{TDM-FM|112|Penny Dreadful 3: Erasing the Trail}}
|Melan and Bikerdude
|{{Forumlink|http://forums.thedarkmod.com/topic/18200-fan-mission-penny-dreadful-3-by-melan-and-bikerdude-20160710}}
|2016-07-09
|200
|No
|[[Fan_Mission_Series#Penny Dreadful series|Penny Dreadful]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|111|Volta 1: Volta and the Stone}}
|Kingsal
|{{Forumlink|http://forums.thedarkmod.com/topic/18087-fan-mission-volta-and-the-stone-by-kingsal-05262016}}
|2016-05-27
|102
|Yes
|[[Fan_Mission_Series#Volta series|Volta]]
|Mansion/Estate City Missions
|
|-

|-
!align=left|{{TDM-FM|110|Full Moon Fever}} (v2.0 2018/02/21)
|Spoonman
|{{Forumlink|http://forums.thedarkmod.com/topic/18066-fan-mission-full-moon-fever-by-spoonman-14052016/}}
|2016-05-14
|21
|No
|
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|109|King of Diamonds}}
|Spooks
|{{Forumlink|http://forums.thedarkmod.com/topic/18064-fan-mission-the-king-of-diamonds-by-spooks-20160513}}
|2016-05-13
|26
|No
|
|City Missions
|Occult themes
|-

|-
!align=left|{{TDM-FM|108|Accountant 2: New in Town}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/18054-fan-mission-the-accountant-2-new-in-town-by-goldwell-20160509/}} [https://www.youtube.com/watch?v=xeuIO_GcYjQ Briefing] [https://www.youtube.com/watch?v=w6e_SJ0_JOM Gameplay trailer]
|2016-05-08
|358
|No
|[[Fan_Mission_Series#The Accountant series|The Accountant]]
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|107|The Smiling Cutpurse}}
|Airship Ballet
|{{Forumlink|http://forums.thedarkmod.com/topic/17850-fan-mission-the-smiling-cutpurse-by-airship-ballet-20160325/}}
|2016-03-25
|87
|No
|
|Mansion/Estate Sewers
|
|-

|-
!align=left|{{TDM-FM|106|Mother Rose}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/17653-fan-mission-mother-rose-by-grayman-20160101/#entry385131/}}
|2016-01-01
|10
|No
|
|Mansion/Estate
|Ghost
|-

|-
!align=left|{{TDM-FM|105|Behind Closed Doors}}
|Bikerdude and the Crucible Team
|{{Forumlink|http://forums.thedarkmod.com/topic/17627-crucible-of-omens-behind-closed-doors-by-bikerdude-the-crucible-team-updated-18122015/}}
|2015-12-19
|359
|Yes
|[[Fan_Mission_Series#Crucible of Omens series|Crucible of Omens]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|103|The Rats Triumphant}}
|Melan
|{{Forumlink|http://forums.thedarkmod.com/topic/17512-fan-mission-the-rats-triumphant-by-melan-20151031/}}
|2015-10-31
|11
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]] (Winner)
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|104|Dead Drunk}}
|Stumpy
|{{Forumlink|http://forums.thedarkmod.com/topic/17511-fan-mission-dead-drunk-by-stumpy-20151030/}}
|2015-10-30
|4
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Tombs, Catacombs & Crypts
|Undead
|-

|-
!align=left|{{TDM-FM|97|Thief's Remorse}}
|Airship Ballet
|{{Forumlink|http://forums.thedarkmod.com/topic/17509-fan-mission-thiefs-remorse-by-airship-ballet-20151030/}}
|2015-10-30
|42
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Tombs, Catacombs & Crypts
|Undead
|-

|-
!align=left|{{TDM-FM|102|Spring Cleaning}}
|Goldwell
|{{Forumlink|http://forums.thedarkmod.com/topic/17510-fan-mission-spring-cleaning-by-goldwell-20151030/}} [https://www.youtube.com/watch?v=JzPpmDK9Fxw Briefing]
|2015-10-30
|45
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Mansion/Estate
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|96|The Golden Skull}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/17497-fan-mission-the-golden-skull-by-sotha-20151024/}}
|2015-10-25
|7
|No
|[[Fan_Mission_Contests#2015_Halloween_Speed-build_Contest|HSC 15]]
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|101|A House of Locked Secrets}}
|Moonbo
|{{Forumlink|http://forums.thedarkmod.com/topic/17163-fan-mission-a-house-of-locked-secrets-by-gelo-moonbo-fleisher-20150528/}} [https://www.youtube.com/watch?v=f5NuTJEZ8VE Trailer]
|2015-05-29
|195
|No
|[[Fan_Mission_Series#Shadowcursed series|Shadowcursed]]
|Church/Cathedral Mansion/Estate
|Horror themes Undead
|-

|-
!align=left|{{TDM-FM|100|Ulysses 2: Protecting the Flock}}
|Sotha
|{{Forumlink|http://forums.thedarkmod.com/topic/17162-fan-mission-ulysses-2-protecting-the-flock-by-sotha-20150528/}}
|2015-05-28
|102
|No
|[[Fan_Mission_Series#Ulysses series|Ulysses]]
|Church/Cathedral
|
|-

|-
!align=left|{{TDM-FM|99|Sir Talbot's Collateral}}
|Baal and Bikerdude
|{{Forumlink|http://forums.thedarkmod.com/topic/17093-fan-mission-sir-talbots-collateral-by-baal-bikerdude-15042015/}} [https://www.youtube.com/watch?v=e3rdZfq4Omc Trailer]
|2015-04-15
|60
|Yes
|[[Fan_Mission_Series#Sir Talbot series|Sir Talbot]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|98|Vengeance for a Thief Part 3}}
|Sir Taffsalot
|{{Forumlink|http://forums.thedarkmod.com/topic/16953-the-complete-vengeance-for-a-thief-campaign/}}
|2015-02-16
|25
|No
|[[Fan_Mission_Series#Vengeance for a Thief series|VFAT]]
|Church/Cathedral
|
|-

|-
!align=left|{{TDM-FM|95|Lord Edgar's Bathhouse}}
|Goldwell
|{{Forumlink|1=http://forums.thedarkmod.com/topic/16828-fan-mission-lord-edgars-bathhouse-by-goldwell-27122014/}} [https://www.youtube.com/watch?v=vYSZY7VzFEo Briefing]
|2014-12-27
|71
|No
|Lord Edgar
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|94|Quinn Co.}} (Made into a campaign, 2015/02/04)
|Airship Ballet
|{{Forumlink|1=http://forums.thedarkmod.com/topic/16912-fan-mission-chase-mercantile-by-airship-ballet-20150204/}}
|2014-11-22
|111
|No
|Quinn Co.
|Bank Jobs
|
|-

|-
!align=left|{{TDM-FM|93|Exhumed}}
|Airship Ballet and Kyyrma
|{{Forumlink|1=http://forums.thedarkmod.com/topic/16658-fan-mission-exhumed-by-kyyrma-and-airship-ballet-20141104/}}
|2014-11-04
|24
|No
|[[Fan_Mission_Contests#2014 Halloween Speed-build Contest|HSC 14]]
|Church/Cathedral Horror
|Undead
|-

|-
!align=left|{{TDM-FM|92|Briarwood Cathedral}}
|buck28
|{{Mirrorlink|http://www64.zippyshare.com/v/25705489/file.html}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16644-briarwood-cathedral/}}
|2014-10-29
|7
|No
|[[Fan_Mission_Series#Master thief Corso series|Corso]] [[Fan_Mission_Contests#2014 Halloween Speed-build Contest|HSC 14]]
|Church/Cathedral Horror
|Undead
|-

|-
!align=left|{{TDM-FM|91|One Step Too Far}}
|Dragofer
|{{Mirrorlink|https://www.dropbox.com/s/sfxcap1gfdzf318/onesteptoofar.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16457-fan-mission-one-step-too-far-by-dragofer-20140804/}}
|2014-08-04
|9
|No
|[[Fan_Mission_Series#Of Brambles and Thorns series|Of Brambles and Thorns]]
|Pirate Ship
|
|-

|-
!align=left|{{TDM-FM|90|Lockner Manor}}
|buck28
|{{Mirrorlink|http://www76.zippyshare.com/v/44108372/file.html}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16452-new-mission-lockner-manor/}}
|2014-08-02
|6
|No
|[[Fan_Mission_Series#Master thief Corso series|Corso]]
|Mansion/Estate Inn/Tavern
|
|-

|-
!align=left|{{TDM-FM|89|Ulysses: Genesis}}
|Sotha
|{{Mirrorlink|http://www4.zippyshare.com/v/67195436/file.html}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16428-fan-mission-ulysses-genesis-by-sotha-20140724/}}
|2014-07-24
|98
|No
|[[Fan_Mission_Series#Ulysses series|Ulysses]]
|Mansion/Estate
|Horror theme?
|-

|-
!align=left|{{TDM-FM|88|Penny Dreadful 2: All the way up}}
|Melan and Bikerdude
|{{Mirrorlink|https://mega.co.nz/#!EwoXHZYZ!tE_sKon2h4AWtWPNt9QS3FQClwmXdimhfjIMPcpCQ34}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16387-fan-mission-penny-dreadful-2-by-melan-and-bikerdude-2014078/}} [https://www.youtube.com/watch?v=WmPfCfbeWvg Trailer]
|2014-07-08
|102
|No
|[[Fan_Mission_Series#Penny Dreadful series|Penny Dreadful]]
|Thieves' Highway / Rooftop
|Spiders
|-

|-
!align=left|{{TDM-FM|87|Poets and Peasants}}
|Digi
|{{Mirrorlink|https://drive.google.com/file/d/0B1HHvWAgbWGfTkI0SXFubXZucXM}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16373-fan-mission-poets-peasants-by-digi-62914}}
|2014-06-29
|1
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|85|A Reputation to Uphold}}
|Springheel
|{{Mirrorlink|http://www.mindplaces.com/follow.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16204-fan-mission-a-reputation-to-uphold-by-springheel/}}
|2014-04-18
|25.5
|No
|[[Fan_Mission_Series#Corbin series|Corbin]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|86|Breaking Out the Fence}}
|Kyyrma
|{{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/breakingout.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16091-fan-mission-breaking-out-the-fence-17032014-by-kyyrma/}}
|2014-03-17
|11.6
|No
|[[Fan_Mission_Series#In A Time of Need series|In A Time of Need]]
|City Missions Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|83|Inn Business}} (v.1.48, 2014/03/08)
|RJFerret
|{{Mirrorlink|https://drive.google.com/file/d/0B81T2ZXLPqhTYWVaODRiSExGeGc}} {{Forumlink|1=http://forums.thedarkmod.com/topic/16018-fan-mission-inn-business-by-rjferret-20140303/}}
|2014-03-03
|6
|No
|
|Inn/Tavern City Streets
|
|-

|-
!align=left|{{TDM-FM|82|William Steele 3: Cleighmoor}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/16011-fan-mission-cleighmoor-by-grayman-201431/#entry338349/}}
|2014-03-01
|38
|No
|[[Fan_Mission_Series#William Steele series|William Steele]]
|Sewers Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|81|William Steele 2: Home Again}}
|grayman
|{{Forumlink|http://forums.thedarkmod.com/topic/15919-fan-mission-home-again-by-grayman-2014212/page__fromsearch__1}}
|2014-02-12
|26
|No
|[[Fan_Mission_Series#William Steele series|William Steele]]
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|80|The Gatehouse}}
|Bikerdude Goldchocobo
|{{Mirrorlink|http://www.southquarter.com/tdm/fms/gatehouse.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15844-fan-mission-the-gatehouse-by-bikerdude-goldchocobo-20140114/}} [https://www.youtube.com/watch?v=kcIe2Ucojqw Briefing]
|2014-01-29
|100
|No
|Remake of Evilartist's Doom 3 mod
|Castle/Fortress
|Ghosts
|-

|-
!align=left|{{TDM-FM|79|Window of Opportunity}} (v.1.43, 2014/01/01)
|RJFerret
|{{Mirrorlink|https://drive.google.com/file/d/0B81T2ZXLPqhTWTMzQXZtMVFBSG8}} {{Forumlink|1=http://forums.thedarkmod.com/topic/15727-fan-mission-window-of-opportunity-by-rjferret-20140101/}}
|2014-01-01
|7
|No
|
|Outdoor/Caves
|Spiders (not in short mode)
|-

|-
!align=left|{{TDM-FM|78|In A Time Of Need}}
|kyyrma
| {{Mirrorlink|http://www.mediafire.com/download/a97or40t1xrybh3/timeofneed_v1.zip}} {{Forumlink|http://forums.thedarkmod.com/topic/15354-fan-mission-in-a-time-of-need-by-kyyrma-20131112/}}
|2013-11-12
|5.6
|No
|[[Fan_Mission_Series#In A Time of Need series|In A Time of Need]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|76|Requiem}}
|Moonbo
| {{Mirrorlink|http://www.mediafire.com/download/l6o3vvj9y78hu89/requiem.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15101-fan-mission-requiem-by-gelo-moonbo-fleisher-2013106/}}
|2013-10-08
|107.3
|No
|[[Fan_Mission_Series#Shadowcursed series|Shadowcursed]]
|Lost Civilizations Church/Cathedral
|Undead
|-

|-
!align=left|{{TDM-FM|75|Vengeance for a Thief Part 2}}
|Sir Taffsalot
| {{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/vfat2.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15051-fan-mission-vengeance-for-a-thief-part-2-by-sir-taffsalot-06092013/}}
|2013-09-06
|22
|No
|[[Fan_Mission_Series#Vengeance for a Thief series|VFAT]] [[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]]
|Museum Heists
|
|-

|-
!align=left|{{TDM-FM|74|Lords and Legacy}}
|Kvorning
| {{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/lordsnlegacy.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/15016-fan-mission-lords-legacy-by-kvorning-20130830/}}
|2013-08-30
|45
|No
|
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|72|Not An Ordinary Guest}}
|Fieldmedic
| {{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/naog.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14965-fan-mission-not-an-ordinary-guest-by-fieldmedic-20130801/}}
|2013-08-01
|79.6
|No
|[[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|71|Penny Dreadful: Grail of Regrets}}
|Melan
| {{Forumlink|http://forums.thedarkmod.com/topic/14952-fan-mission-penny-dreadful-by-melan-20130728/}}
|2013-07-27
|74
|No
|[[Fan_Mission_Series#Penny Dreadful series|Penny Dreadful]]
|Horror
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|70|Solar Escape 1}}
|Tr00pertj
| {{Forumlink|http://forums.thedarkmod.com/topic/14944-fan-mission-solar-escape-1/}}
|2013-07-22
|6
|No
|
|Mansion/Estate Sewers
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|69|The Lich Queen's Demise}}
|Sotha
|{{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/lich_queens_demise.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14826-fan-mission-the-lich-queens-demise-by-sotha-20130520/unread/}}
|2013-05-20
|97.6
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]] [[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]] (Winner)
|Horror
|Undead
|-

|-
!align=left|{{TDM-FM|77|Old Habits Rebuild}}
|Obsttorte
|{{Bloodgate|mc.pk4}} {{Mirrorlink|http://www.mediafire.com/download/u2gwucibh17c45a/oldhabits.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14827-fan-mission-old-habits-rebuild-by-obsttorte-20052013/}}
|2013-05-20
|28.6
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|68|The Builder's Blocks}}
|Jesps
|{{Mirrorlink|https://dl.dropboxusercontent.com/u/17706561/builders_blocks.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14592-unusual-gameplay-contest-fm-the-builders-blocks-by-jesps/}}
|2013-03-18
|2.85
|No
|[[Fan_Mission_Contests#2013 Community Unusual Contest|CUC 13]]
|Experimental
|
|-

|-
!align=left|{{TDM-FM|67|Crystal Grave}} (v.2.0, 2013/02/09)
|ERH+ Bikerdude
|{{Mirrorlink|https://dl.dropbox.com/u/17706561/crystalgravev2.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14510-fan-mission-crystal-grave-v2-by-erh-and-bikerdude-20130209/unread/}}
|2011-11-15
|12.4
|No
|
|Horror
|Undead
|-

|-
!align=left|{{TDM-FM|66|The Builder Roads}}
|Obsttorte
|{{Forumlink|http://forums.thedarkmod.com/topic/14449-fan-mission-the-builder-roads-by-obsttorte-20130119/}}
|2013-01-19
|?
|No
|
|Horror
|Ghosts
|-

|-
!align=left|{{TDM-FM|65|William Steele 1: In the North}}
|grayman
|{{Bloodgate|ws1_north.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14214-fan-mission-in-the-north-by-grayman-20121020/}}
|2012-10-20
|39.8
|No
|[[Fan_Mission_Series#William Steele series|William Steele]]
|Mansion/Estate
|Undead
|-

|-
!align=left|{{TDM-FM|64|Old Habits}}
|Obsttorte
|{{Bloodgate|mc.pk4}} {{Mirrorlink|http://www.mediafire.com/download.php?andes2xnsonssfj}} {{Forumlink|http://forums.thedarkmod.com/topic/14206-fan-mission-old-habits-by-obsttorte-20121019/}}
|2012-10-19
|12.8
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|63|Deceptive Shadows}}
|ShadowHide
|{{Bloodgate|DeceptiveShadows.pk4}} {{Mirrorlink|http://www.sendspace.com/file/jzr9s7}} {{Forumlink|http://forums.thedarkmod.com/topic/14103-fan-mission-deceptive-shadows-by-shadowhide-16sep12/}}
|2012-09-16
|22.4
|No
|
|Outdoor/Pagan
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|62|Vengeance for a Thief: Part 1}}
|Sir Taffsalot
|{{Bloodgate|VFAT1.pk4}} {{Mirrorlink|https://dl.dropbox.com/u/17706561/VFAT1.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/14068-fan-mission-vengeance-for-a-thief-part-1-by-sir-taffsalot-06092012/}}
|2012-09-06
|20.9
|No
|[[Fan_Mission_Series#Vengeance for a Thief series|VFAT]]
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|61|The Phrase Book}}
|Sotha
|{{Bloodgate|phrase_book.pk4}} {{Mirrorlink|http://dl.dropbox.com/u/17706561/phrase_book.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13799-fan-mission-the-phrase-book-by-sotha-20120512/}}
|2012-05-11
|24
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|60|In Remembrance of Him}}
|RPGista
|{{Bloodgate|remembrance.pk4}} {{Mirrorlink|http://dl.dropbox.com/u/17706561/remembrance.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13749-fan-mission-in-remembrance-of-him-by-rpgista/}}
|2012-04-22
|27.6
|No
|[[Fan_Mission_Contests#2012_Community_Beginner_Contest|CBC 12]]
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|59|Rightful Property}}
|jysk
|{{Bloodgate|rightful.pk4}} {{Mirrorlink|http://dl.dropbox.com/u/17706561/rightful1.1b.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13711-fan-mission-rightful-property-by-jysk-20120413/}}
|2012-04-12
|22.5
|No
|[[Fan_Mission_Contests#2012_Community_Beginner_Contest|CBC 12]]
|Bank Jobs
|Spiders
|-

|-
!align=left|{{TDM-FM|58|Sneak and Destroy}}
|SeriousToni
|{{Bloodgate|kneipe24.pk4}} {{Mirrorlink|http://minus.com/mVcf61n3G/1f}} {{Forumlink|http://forums.thedarkmod.com/topic/13706-fan-mission-sneak-destroy-by-serioustoni-beginners-contest-2012/}}
|2012-04-11
|158
|No
|[[Fan_Mission_Contests#2012_Community_Beginner_Contest|CBC 12]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|56|House of Theo}}
|Theothesnopp
|{{Bloodgate|houseoftheo.pk4}} {{Mirrorlink|http://www.gamefront.com/files/21053391/houseoftheo__2__2.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13242-fan-mission-house-of-theo/}}
|2011-12-04
|6.2
|No
|
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|53|Dragon's Claw}}
|Bikerdude, Flanders (map assets)
|{{Bloodgate|claw.pk4}}{{Mirrorlink|http://www.gamefront.com/files/20948800/claw.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13181-fan-missiondragons-claw-by-b1k3rdude-31102011/}}
|2011-10-31
|98
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|52|A Night to Remember}} (v2.0, 2018/05/28)
|Fieldmedic
|{{Bloodgate|antr.pk4}} New → {{Forumlink|http://forums.thedarkmod.com/topic/19452-a-night-to-remember/}} Old → {{Forumlink|http://forums.thedarkmod.com/topic/13177-fan-mission-a-night-to-remember-by-fieldmedic-20111030/}}
|2011-10-31
|33
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Mansion/Estate Horror
|Ghosts
|-

|-
!align=left|{{TDM-FM|51|The Creeps}}
|Mortem Desino
|{{Bloodgate|thecreeps.pk4}}{{Mirrorlink|http://www.gamefront.com/files/20939925/thecreeps.pk4}} {{Forumlink|http://forums.thedarkmod.com/topic/13176-fan-mission-creeps-the-20111030-by-mortem-desino/}}
|2011-10-30
|61
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Horror
|Ghosts
|-

|-
!align=left|{{TDM-FM|50|House in Blackbog Hollow}}
|Stumpy
|{{Bloodgate|blackbog.pk4}}{{Mirrorlink|http://www.bookofages.co.uk/doom3/mods/blackbog.html}} {{Forumlink|http://forums.thedarkmod.com/topic/13172-fan-mission-house-in-blackbog-hollow-by-stumpy-20111028/}}
|2011-10-28
|12
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Horror
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|49|Let Sleeping Thieves Lie}}
|Sir Taffsalot, Bikerdude
|{{Bloodgate|lstl.pk4}}{{Mirrorlink|http://www.mediafire.com/?zkd1jn4lpwgioh9}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/13153-let-sleeping-thieves-lie-by-sir-taffsalot-bikerdude-20102011/}}
|2011-10-20
|13
|No
|
|Tombs, Catacombs & Crypts
|Undead
|-

|-
!align=left|{{TDM-FM|48|Samhain Night}}
|PranQster
|{{Bloodgate|samhain.pk4}}{{Mirrorlink|http://jdchoate.mcn.org/games/darkmod/samhain.zip}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/13127-fan-mission-samhain-night-on-bone-hill-by-pranqster-20111009/}}
|2011-10-09
|10
|No
|[[Fan_Mission_Contests#2011_Halloween_Speed-build_Contest|HSC 11]]
|Horror
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|47|A Score to Settle}}
|Springheel
|{{Bloodgate|score_to_settle.pk4}}{{Mirrorlink|http://www.mediafire.com/?f3o7hm4h4ew7o3l}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12894-fan-mission-%2348-a-score-to-settle-by-springheel-20110701/}}
|2011-07-01
|135
|No
|[[Fan_Mission_Series#Corbin series|Corbin]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|46|Siege Shop}} (v3.0 2013/10/10)
|PranQster and Lowenz
|{{Bloodgate|siegeshop.pk4}}{{Mirrorlink|http://jdchoate.mcn.org/games/darkmod/siegeshop.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12874-fan-mission-the-siege-shop-by-pranqster-20110626/}}
|2011-06-26
|20.51
|No
|
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|44|Alberic's Curse}}
|Bikerdude
|{{Bloodgate|alberic.pk4}} {{Mirrorlink|http://www.gamefront.com/files/20459738/alberic.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12850-fan-mission-alberics-curse-by-b1k3rdude-20062011/}}
|2011-06-20
|29
|No
|[[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]] (Winner) T2 FM homage
|Church/Cathedral
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|45|Reap As You Sow}}
|Fieldmedic
|{{Bloodgate|reap.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12849-fan-mission-reap-as-you-sow-by-fieldmedic-20110619/}}
|2011-06-19
|52
|No
|[[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|Outdoor/Daylight Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|43|Rake Off}}
|Jesps
|{{Bloodgate|rake_off.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12846-fm-rake-off-19-06-2011/}}
|2011-06-19
|8
|No
|[[Fan_Mission_Series#Selis Woderose series|Selis Woderose]] [[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|42|Winter Harvest}} (v2.0 2011/07/24 with Bikerdude)
|ShadowHide
|{{Bloodgate|winterharvest.pk4}} {{Forumlink|http://forums.thedarkmod.com/index.php?/topic/12690-seasons-contest-entry-winter-harvest-by-shadowhide/}}
|2011-05-08
|10
|No
|[[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|Outdoor/Pagan
|Spiders
|-

|-
!align=left|{{TDM-FM|41|Fiasco at Fauchard Street}}
|Melan
|{{Bloodgate|fauchard.pk4}} {{Mirrorlink|https://rapidshare.com/files/460141132/fauchard.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12655-fan-mission-fiasco-at-fauchard-street-by-melan-20110501//}}
|2011-05-01
|62
|No
|[[Fan_Mission_Series#Sir Talbot series|Sir Talbot]]
|Thieves' Highway / Rooftop
|
|-

|-
!align=left|{{TDM-FM|40|Mandrasola}}
|Sotha
|{{Bloodgate|mandrasola.pk4}} {{Mirrorlink|http://www.mediafire.com/?2ox2nbhh796ne71}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12575-fan-mission-mandrasola-by-sotha-20110410/}}
|2011-04-10
|10
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]] [[Fan_Mission_Contests#2011_Community Seasons Contest|CSC 11]]
|City Missions
|Undead
|-

|-
!align=left|[http://www.southquarter.com/tdm/fms/yantdm1.1.pk4 Q4 Conversion: Yan's Test]
|Bikerdude
|{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12506-fan-mission-q4-map-conversion-yantdm1-280311/}}
|2011-03-28
|28
|No
|
|
|
|-

|-
!align=left|{{TDM-FM|38|The Transaction}}
|Sotha
|{{Bloodgate|transaction.pk4}} {{Mirrorlink|http://www.mediafire.com/?ux7mx79wumnvcb6}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12408-fan-mission-the-transaction-by-sotha-20110304/}}
|2011-03-04
|10
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|City Missions
|
|-

|-
!align=left|{{TDM-FM|13|Return to the City}} (v3.0 2015/01/03)
|Melan, Bikerdude
|{{Bloodgate|ReturnToTheCityV2.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10509-fan-mission-return-to-the-city-by-melan-20100110/}} {{Forumlink|1=http://www.ttlg.com/forums/showthread.php?t=130519/}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12390-fan-mission-return-to-the-city-v2-01032011/}}
|2010-01-10
|26
|No
|[[Fan_Mission_Series#Sir Talbot series|Sir Talbot]] [[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]] (Winner)
|City Missions
|
|-

|-
!align=left|{{TDM-FM|39|Lockdown}}
|GameDevGoro Bikerdude Fidcal
|{{Bloodgate|lockdown1_2_1.pk4}} {{Mirrorlink|http://www.fidcal.com/darkuser/missions/lockdown1_2_1.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/12064-fm-lockdown-part-1-by-gamedevgoro-and-bikerdude-20101224/}}
|2010-12-25
|3
|No
|Lockdown 1
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|37|Flakebridge Monastery}}
|Jesps
|{{Bloodgate|flakebridge.pk4}} {{Mirrorlink|http://www.file-upload.net/download-3024426/flakebridge.pk4.html}} {{Mirrorlink|http://rapidshare.com/files/434997519/flakebridge.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11991-fm-flakebridge-monastery-by-jesps/}}
|2010-12-05
|16
|No
|[[Fan_Mission_Series#Selis Woderose series|Selis Woderose]]
|Church/Cathedral
|Undead
|-

|-
!align=left|{{TDM-FM|36|Knighton Manor, The}}
|Sotha
|{{Bloodgate|knighton_manor.pk4}} {{Mirrorlink|http://www.mediafire.com/?xrdts3j4t2qxre2}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11898-fan-mission-the-knighton-manor-by-sotha-20101109/page__view__getnewpost}}
|2010-11-09
|21
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|35|St Albans Cathedral}} (v2.0 2014/06/11)
|Bikerdude
|{{Bloodgate|stac160.pk4}} [[http://www.bloodgate.com/fms/stac142.pk4 Classic]] {{Mirrorlink|http://www.filefront.com/17464439/stac141.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/topic/16343-fan-mission-st-albans-cathedral-v20-11062014/}} {{Loot|FM:TDM_St_Alban's_Cathedral_-_Bikerdude}}
|2010-11-01
|67
|No
|[[Fan_Mission_Series#St Alban series|St Alban]]
|Church/Cathedral
|Undead
|-

|-
!align=left|{{TDM-FM|33|Swing}}
|Komag
|{{Bloodgate|swing_v1.2.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11660-vertigo-contest-entry-swing-by-komag-20100825/}} {{Loot|FM:TDM_Swing_-_Komag}}
|2010-08-25
|3
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Platforming/Jumping Experimental
|
|-

|-
!align=left|{{TDM-FM|32|The Caduceus of St. Alban}} (v.1.5.5 2010/08/26)
|Bikerdude
|{{bloodgate|stalban.pk4}} {{Mirrorlink|http://www.filefront.com/17237609/stalban.pk4/}}{{Forumlink|http://forums.thedarkmod.com/topic/11644-the-caduceus-of-st-alban-vertical-fm-contest-entry-aug-8th-2010/}}
|2010-08-23
|11.3
|No
|[[Fan_Mission_Series#St Alban series|St Alban]] [[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Church/Cathedral
|Spiders
|-

|-
!align=left|{{TDM-FM|30|Somewhere Above the City}} (v1.1 2010/08/27)
|grayman
|{{Bloodgate|somewhere1.1.pk4}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11619-vertical-contest-mission-somewhere-above-the-city-by-grayman-aug-20-2010/}} {{Loot|FM:TDM_Somewhere_Above_the_City_-_grayman}}
|2010-08-20
|11
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Tombs, Catacombs & Crypts
|
|-

|-
!align=left|{{TDM-FM|29|Betrayal}} (v.1.1, 2010/09/01)
|Fieldmedic
|{{Bloodgate|betrayal.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11605-betrayal-by-fieldmedic-20100817-summer-fm-vertical-contest-entry/}} {{Loot|FM:TDM_Awaiting_the_Storm_-_HappyCheeze}}
|2010-08-17
|12
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Horror
|Undead
|-

|-
!align=left|{{TDM-FM|31|Rift, The}}
|Baddcog
|{{Bloodgate|rift.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11599-vert-contest-mission-the-rift-by-baddcog-aug-15-2010/}}
|2010-08-15
|10
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Lost Civilizations
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|34|Illusionist's Tower}}
|stumpy
|{{Bloodgate|holetower.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11541-illusionists-tower-by-stumpy-201085-summer-fm-vertical-contest-entry}} {{Forumlink|1=http://www.bookofages.co.uk/doom3/mods/holetower.html}} {{Loot|FM:TDM_Illusionist%27s_Tower_-_stumpy}}
|2010-08-05
|9
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Horror Experimental
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|28|Mad's Mountain}}
|Jesps
|{{Bloodgate|madmountain.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11510-fan-mission-mads-mountain-by-jesps-20100731}} {{Loot|FM:TDM_Lord_Dufford%27s_-_stumpy}}
|2010-07-31
|2
|No
|[[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]]
|Outdoor/Caves
|
|-

|-
!align=left|{{TDM-FM|27|Glenham Tower, The}}
|Sotha
|{{Bloodgate|glenham_tower.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11423-fan-mission-the-glenham-tower-by-sotha-20100717}}
|2010-07-17
|5
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]] [[Fan_Mission_Contests#2010 Summer Vertical Contest|SVC 10]] (Winner)
|Castle/Fortress Horror
|Undead
|-

|-
!align=left|{{TDM-FM|25|Pandora's Box}}
|Jesps, Fidcal
|{{Bloodgate|pandoras_box.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11381-fan-mission-pandoras-box-by-jesps20100711}} {{Loot|FM:TDM_Pandora%27s_Box_-_Jesps}}
|2010-07-11
|7
|No
|
|Pirate Ship Experimental
|
|-

|-
!align=left|{{TDM-FM|23|Beleaguered Fence, The}}
|Sotha
|{{Bloodgate|beleaguered_fence.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11298-fan-mission-the-beleaguered-fence-by-sotha-20100623}} {{Loot|FM:TDM_The_Beleaguered_Fence_-_Sotha}}
|2010-06-23
|11
|No
|[[Fan_Mission_Series#Thomas Porter series|Thomas Porter]]
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|22|Special Delivery, A}}
|Silencium18
|{{Bloodgate|delivery.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11247-fan-mission-a-special-delivery-by-silencium1820100612}} {{Loot|FM:TDM_A_Special_Delivery_-_Silencium18}}
|2010-06-12
|2
|No
|
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|21|Alchemist, The}} (2010/06/04)
|Sotha, Fidcal
|{{Bloodgate|alchemist.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11170-fan-mission-the-alchemist-by-sotha-fidcal20100601}} {{Loot|FM:TDM_The_Alchemist_-_Sotha_%26_Fidcal}}
|2010-06-01
|27
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|City Missions
|Undead
|-

|-
!align=left|{{TDM-FM|20|Awaiting The Storm}}
|HappyCheeze
|{{Bloodgate|storm.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11095-fm-awaiting-the-storm-by-happycheeze-20200522}} {{Loot|FM:TDM_Awaiting_the_Storm_-_HappyCheeze}}
|2010-05-22
|4
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|19|Sound Alert & Blackjack Trainer}}
|Dark Mod Team
|
|2010-05-14
|0.2
|No
|
|Training
|
|-

|-
!align=left|{{TDM-FM|18|No Honor Among Thieves}} (v.3.0, 2015/05/30)
|Goldchocobo, RailGun, Mortem Desino, Bikerdude
|{{Mirrorlink|http://tinyurl.com/2a9mdcs}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10993-fan-mission-no-honor-among-thieves-20100429}} {{Loot|FM:TDM_No_Honor_Among_Thieves_-_Goldchocobo}}
|2010-04-29
|203
|No
|
|Church/Cathedral; City Missions; Outdoor/Pagan, Mansion/Estate
|Undead and Spiders
|-

|-
!align=left|{{TDM-FM|17|Heart of Lone Salvation, The}} (v.2.0, 2014/04/12)
|Fidcal, Baddcog, Bikerdude
|{{Bloodgate|heart.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/topic/10878-fan-mission-the-heart-of-lone-salvation-by-fidcal-baddcog-bikerdude-20100402/?p=213506}} {{Walkthrough|FM:TDM_The_Heart_of_Lone_Salvation_-_Fidcal_%26_Baddcog_%26_Bikerdude}} {{loot|FM:TDM_The_Heart_of_Lone_Salvation_-_Fidcal_%26_Baddcog_%26_Bikerdude}}
|2010-04-02
|41
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|City Missions
|Spiders
|-

|-
!align=left|{{TDM-FM|73|Lord Dufford's}}
|stumpy
|{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10868-fan-mission-lord-duffords-20100331}} {{Loot|FM:TDM_Lord_Dufford%27s_-_stumpy}}
|2010-03-31
|22
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|16|Builder's Influence, The}} (2010/03/23)
|Railgun, Springheel
|{{Bloodgate|builders_influence.pk4}} {{Mirrorlink|http://www.fidcal.com/darkuser/missions/builders_influence.pk4}}{{Forumlink|http://forums.thedarkmod.com/index.php?/topic/10811-fan-mission-the-builders-influence-20100320/}} {{Loot|FM:TDM_The_Builders_Influence_-_Railgun%26Springheel}}
|2010-03-20
|15
|No
|[[Fan_Mission_Series#Corbin series|Corbin]]
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|14|Business as Usual}} (v2.0 2011/09/24)
|Bikerdude
|{{Bloodgate|business.pk4}}{{Mirrorlink|1=http://rapidshare.com/files/335299431/business.pk4.html}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10533-fan-mission-business-as-usual-by-b1k3rdude-14012010-christmas-fm-contest-entry/page__view__findpost__p__207055}}
|2010-01-14
|4
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Sewers
|
|-

|-
!align=left|{{TDM-FM|12|Sons of Baltona 1, The}}
|Carnage
|{{Bloodgate|sons_of_baltona_1.pk4}} {{Mirrorlink|1=http://www.mediafire.com/?m4ywobjodm0}}{{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10498-fan-mission-the-sons-of-baltona-1-by-carnage-20100109}}
|2010-01-09
|3
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]] / Baltona 1
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|11|Living Expenses}}
|Sonosuke
|{{Bloodgate|living_expenses.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10451-fm-living-expenses-by-sonosuke-2-jan-10/page__view__findpost__p__205386}}
|2010-01-02
|6
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|10|Trapped!}}
|RailGun
|{{Bloodgate|trapped.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10442-fm-trapped-by-railgun-dec-30/page__view__findpost__p__205092}}
|2009-12-30
|6
|No
|
|Jail/Prison
|
|-

|-
!align=left|{{TDM-FM|8|Parcel, The}}
|Xonze
|{{Bloodgate|parcel.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10404-fm-the-parcel-by-xonze-dec-24/page__view__findpost__p__204459}}
|2009-12-24
|7
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|9|Too Late}}
|Nielsen74
|{{Bloodgate|too_late.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10400-fm-too-late-by-nielsen74-24-dec-09/page__view__findpost__p__204396}}
|2009-12-24
|4
|No
|[[Fan_Mission_Contests#2009 Grand Christmas Contest|GCC 09]]
|Warehouse
|
|-

|-
!align=left|{{TDM-FM|7|Thieves}}
|Silencium, RailGun, Fidcal
|{{Bloodgate|thieves.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10286-fm-the-thieves-nov-2509/}}
|2009-11-26
|9
|No [https://www.moddb.com/mods/the-dark-mod/addons/unofficial-thieves-efx Unofficial EFX Build]
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|6|Patently Dangerous}} (v.2.0, 2013/10/08)
|demagogue
|{{Bloodgate|patently_dangerous.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10125-fm-patently-dangerous-oct3109/page__view__findpost__p__199324/}}
|2009-10-31
|24
|No
|
|City Missions
|
|-

|-
!align=left|{{TDM-FM|5|Dark Mod Training Mission, The}}
|TDM Team
|{{Bloodgate|training_mission.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9932-fm-training-mission-17-oct-09/}}
|2009-10-17
|6
|No
|[[Fan_Mission_Series#Introduction_campaign|Official Campaign]]
|Training Platforming/Jumping
|
|-

|-
!align=left|{{TDM-FM|2|Crown of Penitence, The}}
|Jesps
|{{Bloodgate|crow_of_penitence.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9934-fm-crown-of-penitence-by-jesps-17-oct-09/}}
|2009-10-16
|12
|No
|
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|3|Chalice of Kings, The}} (v.2.0, 2015/09/24) (Bikerdude and Xarg)
|Fidcal
|{{Bloodgate|chalice.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9935-fm-chalice-of-kings-by-fidcal-17-oct-09/}} {{Loot|FM:TDM_Chalice_of_Kings_-_Fidcal}}
|2009-10-15
|3
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|1|Outpost, The}}
|angua, greebo
|{{Bloodgate|outpost.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/9937-fm-the-outpost-by-angua-greebo-17-oct-09/}}
|2008-12-23
|2
|No
|
|Castle/Fortress
|
|-

|-
!align=left|{{TDM-FM|15|Mission 2: Tears of Saint Lucia, The}} (v.3.0, 2017/02/14)
|TDM Team
|{{Bloodgate|saintlucia.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/10579-fan-mission-the-tears-of-st-lucia-20081021/page__view__findpost__p__207972}} {{Loot|FM:TDM_The_Tears_of_Saint_Lucia_-_jdude}} [https://www.youtube.com/watch?v=yrGxoi3LSGg Briefing]
|2008-10-21
|20.3
|No
|[[Fan_Mission_Series#Introduction_campaign|Official Campaign]]
|Church/Cathedral
|Spiders
|-

|-
!align=left|{{TDM-FM|57|Closemouthed Shadows}} (v.2.0, 2012/01/15)
|LordSavage, Bikerdude
|{{Bloodgate|closemouthed_shadows.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/topic/13383-fan-mission-closemouthed-shadows-2008-reworked-for-tdm-107-20120115/}}
|2008-09-21
|2
|No
|Closemouthed Shadows 1
|Mansion/Estate
|
|-

|-
!align=left|{{TDM-FM|24|Thief's Den}} (v.2.0, 2010/07/04)
|Fidcal, greebo
|{{Bloodgate|thiefs_den.pk4}} {{Forumlink|1=http://forums.thedarkmod.com/index.php?/topic/11347-fan-mission-thiefs-den-re-release-by-fidcal20100704}} {{Walkthrough|FM:TDM_Thief's_Den_-_Fidcal}} {{Loot|FM:TDM_Thief%27s_Den_-_Fidcal}}
|2008-01-18
|3
|No
|[[Fan_Mission_Series#Thief's Den series|Thief's Den]]
|City Missions
|
|}

To see a speculative list of Upcoming Fan Missions, please visit: [[Upcoming Fan Missions]]

== Table notes ==

'''Links Key'''
{|class="wikitable" border=1 style="border-collapse: collapse;" cellspacing=0 cellpadding=2
|-
|[http://wik.thedarkmod.com/images/b/be/Icon_forum.png http://wiki.thedarkmod.com/images/b/be/Icon_forum.png]
|Link to discussion in Forums
|-
|{{Mirrorlink|}}
|Misc. download mirror
|-
|{{Bloodgate|}}
|Bloodgate download mirror
|-
|{{Loot|}}
|Loot list
|-
|{{Walkthrough|}}
|Walkthrough
|}

----

'''Mission Type Key'''

''Bear in mind that individual FMs can have combinations of two or three of these overarching genres/themes, rather than just a single one.''

{|class="wikitable" border=1 style="border-collapse: collapse;" cellspacing=0 cellpadding=2
|-
|'''''Bank Jobs'''''
|Fan mission involving a heist or other thievy action inside a local banking institution. Will often contain the outsmarting of security systems, gaining access to a safe and cracking its code.
|-
|'''''Castle/Fortress'''''
|Fan mission involving a heist or other thievy action inside or outside a castle or fortress, either one that serves as a military garrison, or as someone's private residence. Frequently involves background characters from the nobility.
|-
|'''''City Missions'''''
|Fan mission that is set mainly in the streets and public spaces of an urban area, such as a town or city. Though the player is most often out on the streets, these missions tend to also involve some degree of exploration and infiltration into private and public buildings alike.
|-
|'''''Church/Cathedral'''''
|Fan mission set in and around religious buildings and institutions, such as churches, monasteries, cathedrals, church bureaus, church workshops, etc. Frequently involves [[Clergy/Builder_Characters|ecclesiastical characters]] from the TDM setting's [[Builders|Builder Church]].
|-
|'''''Experimental'''''
|Fan mission which involves some creative design or gameplay element that isn't typical for the vast majority of TDM missions. FMs set in highly unusual environments, or with a puzzle-like nature, can fit under this label.
|-
|'''''Inn/Tavern'''''
|Fan mission set mostly in and around an inn, tavern or shanty. Usually focused on robbing some rich guest, acquiring an item stored by the guest at the inn, or gathering intel at the inn.
|-
|'''''Jail/Prison'''''
|Fan mission involving an escape from a prison (by the imprisoned player character), infiltration of a prison to gather intel from inmates or help an inmate escape the prison, etc.
|-
|'''''Lost Civilizations'''''
|Fan mission focused on the exploration of ancient ruins, whether above ground or in deep subterranean caverns. Can often overlap with the ''Horror'' or ''Tombs, Catacombs & Crypts'' type of mission, but not necessarily.
|-
|'''''Horror'''''
|Fan mission with an overt horror theme. Depending on the author's approach and intentions, it can focus on psychological horror, or horror based on danger from supernatural threats, or varying combinations of both.
|-
|'''''Mansion/Estate'''''
|Fan mission involving a heist or other thievy action inside someone's private residence (a fancy house, a manor house) and its surrounding grounds. Frequently involves background characters from the nobility or the more affluent townsmen or citizens.
|-
|'''''Museum Heists'''''
|Fan mission focusing on a heist in a museum, art gallery or other institution storing priceless artefacts, artworks, gemstone collections, etc.
|-
|'''''Outdoor/Caves'''''
|Fan mission set in a mostly natural outdoor environment, but involving the exploration of natural caves and caverns.
|-
|'''''Outdoor/Daylight'''''
|Fan mission set in a mostly outdoor environment, during the daytime (in contrast to the usual TDM missions, set at night time or early dusk).
|-
|'''''Outdoor/Pagan'''''
|Fan mission set in a mostly natural outdoor environment, involving some presence of [[Pagans|pagan tribes]] from TDM's setting. Perhaps even pagan camps and settlements.
|-
|'''''Pirate'''''
|Fan mission involving the presence of characters engaging in piracy or smuggling, and various related piratical themes. Can overlap with the ''Ship'' type of mission, but not necessarily.
|-
|'''''Platforming/Jumping'''''
|Fan mission focusing on testing the player's movement, jumping and climbing skills, with or without equipment.
|-
|'''''Sewers'''''
|Fan mission which involves the use of the city sewers or others sewers in some way, often as a stealthy means of entry or escape.
|-
|'''''Ship'''''
|Fan mission which takes place aboard a vessel, in port or at sea, or otherwise involves ships to a great degree. Can overlap with the ''Pirate'' type of mission, but not necessarily.
|-
|'''''Thieves' Highway / Rooftop'''''
|Fan mission involving a lot of movement and travel on the rooftops of a town or city (colloquially "The Thieves' Highway").
|-
|'''''Tombs, Catacombs & Crypts'''''
|Fan mission involving the exploration of old tombs, catacombs and crypts, often for the purposes of treasure and artefact hunting. Can often overlap with the ''Horror'' or ''Lost Civilizations'' type of mission, but not necessarily.
|-
|'''''Training'''''
|Fan mission label that is unique to the official Training Mission, an open-ended tutorial mission where players can practice and test their TDM gameplay skills at their own leisure, and to the smaller blackjacking-trainer FM, which focuses on practicing NPC knockouts by the player.
|-
|'''''Warehouse'''''
|Fan mission which takes place in and around a warehouse, usually in some industrial area of a city, or at a port.
|}

----

'''Contest Key'''

GCC 09: [[Fan_Mission_Contests#2009 Grand Christmas Contest|Grand Christmas Contest 2009]]

SVC 10: [[Fan_Mission_Contests#2010 Summer Vertical Contest|Summer Vertical Contest 2010]]

CSC 11: [[Fan_Mission_Contests#2011 Community Seasons Contest|Community Seasons Contest 2011]]

HSC 11: [[Fan_Mission_Contests#2011 Halloween Speed-build Contest|Halloween Speed-Build Contest 2011]]

CBC 12: [[Fan_Mission_Contests#2012 Community Beginner Contest|Community Beginner Contest 2012]]

CUC 13: [[Fan_Mission_Contests#2013 Community Unusual Contest|Community Unusual Contest 2013]]

HSC 14: [[Fan_Mission_Contests#2014 Halloween Speed-build Contest|Halloween Speed-Build Contest 2014]]

HSC 15: [[Fan_Mission_Contests#2015 Halloween Speed-build Contest|Halloween Speed-Build Contest 2015]]

----

== Editing this table ==
* Please only include playable missions that are fully released, not those currently in development or testing. Tutorials, demos, prefabs, etc. should be listed elsewhere.
* A mission title may be listed in plain text as a record of release, or preferably a link to an information page or primary direct download.
* List by release date descending (newest at the top).
* If a fan mission only has a single mirror/host please consider adding additional mirrors.

== See also ==
* [[Fan Mission Series]] - An overview of all currently known series or campaigns of fan missions interconnected by their stories or characters. There are already plenty in TDM, and have been since its early days as an expandable game.
* [[Mission recommendation discussions]] - An overview of past discussions on what FMs the community recommends to players looking for various challenges (difficulty, size, theme, setting, objectives, etc.).
* [[Fan Mission Contests]] - An overview of past and present contests in Fan Mission creation, by members of the TDM community.
* [[Upcoming Fan Missions]] - An overview of Fan Missions in development or tentatively planned. (''Do not'' edit the overview.)

{{general|sort=Fan Missions}}
[[Category:Fan Missions]]
[[Category:Official FMs| ]]

User:VanishedOne

2019-09-03T17:46:39Z

VanishedOne: /* Misc. */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Emitted to what?

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] so maybe it survived in Prey?)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky.

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` arg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2019-09-03T17:43:28Z

VanishedOne: /* Misc. */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Emitted to what?

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] so maybe it survived in Prey?)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky.

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

There seems to be a TDM-specific decl class called tdm_matinfo, intended to appear within .mtr files. 'A TDM-specific material information declaration class. Currently, the only info it contains is surfacetype.' Unused?

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` spawnarg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

Texture Sources

2019-08-31T00:06:02Z

VanishedOne:

Here is a list of sites where you can download some decent textures. Note that most textures available these days are procedurally generated and made for PBR materials. TDM uses a non-PBR engine (idtech4), so these textures typically require some work to make them look good in game. See [[Textures]] for more information.

===Free===
* [http://textures.one/ Textures.one] - search engine for multiple free texture sites.
* [https://texturehaven.com/textures/ Texture Haven] – 1k to 8k textures, no signup required.
* [https://cc0textures.com/ CC0 Textures] – 2k to 8k textures and Substance files, no registration required.
* [https://www.sharetextures.com/ Share Textures] - seamless, CC0, no registration required.
* [https://www.cgbookcase.com/textures/ cgbookcase.com] - CC0, PBR, no registration required.
* [https://3dtextures.me/ 3DTextures.me] - CC0, no registration required. Free for basic downloads (Patreon supporters may get higher resolutions + source files).
* [https://opengameart.org/art-search-advanced?keys=&field_art_type_tid%5B%5D=14&sort_by=count&sort_order=DESC OpenGameArt textures category] - No registration required. CC and/or GPL [https://opengameart.org/content/faq#q-proprietary licences]. Lets you search by licence.
* [https://hdrihaven.com/hdris/ HDRI Haven] - photographic panoramas for skyboxes, etc. CC0, no registration required. You'll need to [https://matheowis.github.io/HDRI-to-CubeMap/ convert them to cubemaps].
* [https://www.rigzsoft.co.uk/portfolio/particle-collection-1/ A collection of royalty-free particle shapes] from the makers of the TimelineFX software.

===Other sources===
* [https://www.poliigon.com/search?is_free=true Poliigon] – Textures, brushes, models, and HDRI maps, usually for architectural rendering. Only some of those are free. Textures from 1k to 8k. Requires login credentials.
* [https://quixel.com/megascans/library/free Quixel Megascans] – Textures and models, selected free assets. Signup required.

Please add to this list.

{{textures}}

Texture Sources

2019-08-29T01:50:14Z

VanishedOne:

Here is a list of sites where you can download some decent textures. Note that most textures available these days are procedurally generated and made for PBR materials. TDM uses a non-PBR engine (idtech4), so these textures typically require some work to make them look good in game. See [[Textures]] for more information.

===Free===
* [http://textures.one/ Textures.one] - search engine for multiple free texture sites.
* [https://texturehaven.com/textures/ Texture Haven] – 1k to 8k textures, no signup required.
* [https://cc0textures.com/ CC0 Textures] – 2k to 8k textures and Substance files, no registration required.
* [https://www.sharetextures.com/ Share Textures] - seamless, CC0, no registration required.
* [https://www.cgbookcase.com/textures/ cgbookcase.com] - CC0, PBR, no registration required.
* [https://opengameart.org/art-search-advanced?keys=&field_art_type_tid%5B%5D=14&sort_by=count&sort_order=DESC OpenGameArt textures category] - No registration required. CC and/or GPL [https://opengameart.org/content/faq#q-proprietary licences]. Lets you search by licence.
* [https://hdrihaven.com/hdris/ HDRI Haven] - photographic panoramas for skyboxes, etc. CC0, no registration required. You'll need to [https://matheowis.github.io/HDRI-to-CubeMap/ convert them to cubemaps].
* [https://www.rigzsoft.co.uk/portfolio/particle-collection-1/ A collection of royalty-free particle shapes] from the makers of the TimelineFX software.

===Other sources===
* [https://www.poliigon.com/search?is_free=true Poliigon] – Textures, brushes, models, and HDRI maps, usually for architectural rendering. Only some of those are free. Textures from 1k to 8k. Requires login credentials.
* [https://quixel.com/megascans/library/free Quixel Megascans] – Textures and models, selected free assets. Signup required.

Please add to this list.

{{textures}}

User:VanishedOne

2019-08-29T01:40:54Z

VanishedOne: /* ShaderParms */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Emitted to what?

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] so maybe it survived in Prey?)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky.

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comments on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

// screen damage blobs
//
// the alpha paramater (parm3) will decrease from 1.0 to 0.0 over the length of
// time on screen

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` spawnarg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2019-08-29T01:37:02Z

VanishedOne: /* ShaderParms */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Emitted to what?

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] so maybe it survived in Prey?)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky.

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

id's comment on damage overlays (I'm unsure how much of this is active in TDM, given that D3's doublevision is disabled):

// player damage tunnel vision effect
//
// parm3 will range from 0.0 to 1.0 based on health, 1.0 is full health
// parm0 will be the time that damage was last taken, allowing an
// accentuation and fade out

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` spawnarg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2019-08-29T01:28:18Z

VanishedOne: /* ShaderParms */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Emitted to what?

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] so maybe it survived in Prey?)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky.

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

id's comment on the decalFade table:

// this will be full intensity for 90% of the time, then fade to 0
// parm3 is set to the time the mark is spawned
// parm4 is set to the time the mark will be removed

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` spawnarg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

User:VanishedOne

2019-08-27T02:53:41Z

VanishedOne: /* Misc. */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Emitted to what?

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] so maybe it survived in Prey?)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky.

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def? A target_air/idTarget_Air turned up in Q4's defs.

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` spawnarg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.

Texture Sources

2019-08-26T21:48:41Z

VanishedOne:

Here is a list of sites where you can download some decent textures. Note that most textures available these days are procedurally generated and made for PBR materials. TDM uses a non-PBR engine (idtech4), so these textures typically require some work to make them look good in game. See [[Textures]] for more information.

===Free===
* [http://textures.one/ Textures.one] - search engine for multiple free texture sites.
* [https://texturehaven.com/textures/ Texture Haven] – 1k to 8k textures, no signup required.
* [https://cc0textures.com/ CC0 Textures] – 2k to 8k textures and Substance files, no registration required.
* [https://www.sharetextures.com/ Share Textures] - seamless, CC0, no registration required.
* [https://opengameart.org/art-search-advanced?keys=&field_art_type_tid%5B%5D=14&sort_by=count&sort_order=DESC OpenGameArt textures category] - No registration required. CC and/or GPL [https://opengameart.org/content/faq#q-proprietary licences]. Lets you search by licence.
* [https://hdrihaven.com/hdris/ HDRI Haven] - photographic panoramas for skyboxes, etc. CC0, no registration required. You'll need to [https://matheowis.github.io/HDRI-to-CubeMap/ convert them to cubemaps].
* [https://www.rigzsoft.co.uk/portfolio/particle-collection-1/ A collection of royalty-free particle shapes] from the makers of the TimelineFX software.

===Other sources===
* [https://www.poliigon.com/search?is_free=true Poliigon] – Textures, brushes, models, and HDRI maps, usually for architectural rendering. Only some of those are free. Textures from 1k to 8k. Requires login credentials.
* [https://quixel.com/megascans/library/free Quixel Megascans] – Textures and models, selected free assets. Signup required.

Please add to this list.

{{textures}}

Texture Sources

2019-08-25T18:48:54Z

VanishedOne:

Here is a list of sites where you can download some decent textures. Note that most textures available these days are procedurally generated and made for PBR materials. TDM uses a non-PBR engine (idtech4), so these textures typically require some work to make them look good in game. See [[Textures]] for more information.

===Free===
* [http://textures.one/ Textures.one] - search engine for multiple free texture sites.
* [https://texturehaven.com/textures/ Texture Haven] – 1k to 8k textures, no signup required.
* [https://cc0textures.com/ CC0 Textures] – 2k to 8k textures and Substance files, no registration required.
* [https://www.sharetextures.com/ Share Textures] - seamless, CC0, no registration required.
* [https://hdrihaven.com/hdris/ HDRI Haven] - photographic panoramas for skyboxes, etc. CC0, no registration required. You'll need to [https://matheowis.github.io/HDRI-to-CubeMap/ convert them to cubemaps].
* [https://www.rigzsoft.co.uk/portfolio/particle-collection-1/ A collection of royalty-free particle shapes] from the makers of the TimelineFX software.

===Other sources===
* [https://www.poliigon.com/search?is_free=true Poliigon] – Textures, brushes, models, and HDRI maps, usually for architectural rendering. Only some of those are free. Textures from 1k to 8k. Requires login credentials.
* [https://quixel.com/megascans/library/free Quixel Megascans] – Textures and models, selected free assets. Signup required.

Please add to this list.

{{textures}}

Creatures

2019-08-25T14:57:35Z

VanishedOne: Horses can move around (though they lack an animation for turning on the spot, so the swivelling looks bad); it's just that mappers most often have them idling.

{{infobox|bg=#ffb0b0|border=2px solid#ff0000|text=
{{{text|This page features potential '''SPOILERS''' about the contents of ''The Dark Mod'' and some of its Fan Missions. Do not proceed further if you like surprises and don't want to be spoiled.}}}
}}

The [[Universe|TDM universe]] is a mostly grounded, realistic setting, and its fauna and flora corresponds to what you'd expect from the real world. However, one of the fantasy elements of the setting is the presence of several types of fictional creatures, some of them strange animals and beasts, others outright monsters. Some come in animal forms, some in humanoid ones. In the game itself, they usually appear as AI models, similar to human AI characters.

This article serves as a bit of an overview on the non-human creatures seen in TDM's history thus far. Some are already fully finished, fully tested, and part of the core mod. Some are merely proposals or are currently in development limbo. Bear in mind that not every undeveloped concept can or needs to be added to TDM.

== Core TDM ==

This section lists examples of natural or supernatural creatures and beings (other than humans) that are currently a part of The Dark Mod, or were planned for inclusion to ''The Dark Mod'' in the past.

=== Creatures used in TDM ===

These are creatures that are currently an official part of ''The Dark Mod'', in one way or another.

'''Animals'''
*'''''Cats''''' - only as ambient sounds in certain missions; a possible addition was discussed [http://forums.thedarkmod.com/topic/16811-cats-and-dogs/ here]
*'''''Dogs''''' - only as ambient sounds in certain missions; a possible addition was discussed [http://forums.thedarkmod.com/topic/16811-cats-and-dogs/ here]
*'''''Horses''''' - Horse AI, usually seen idling in stables; come with several variations of saddlecloths
*'''''Rats''''' - small, fully animated AI, can be included in FMs to scurry around, for added atmosphere
*'''''Snails''''' - stationary, "set-dressing" models
*'''''Spiders''''' - fairly small, greyish spider; harmless compared to their monstrous cousins

'''Fantasy beasts'''
*'''''[[Giant Spiders]]''''' - huge spiders, in several size varieties (some the size of a plate, the biggest ones the size of a large dog)

'''Undead beings'''
*'''''[[Undead|Revenants]]''''' - animated corpses of [[Builders]] executed for heresies, haunting crypts and vengeful
*'''''Skeletons''''' - aside from more fleshy undead beings, one can occassionally stumble upon walking, roaming, haunted skeletons; they come in several appearance variations and are often armed
*'''''[[Undead|Zombies]]''''' - walking corpses of the long dead

'''Elementals'''
*'''''[[Fire Elementals]]''''' - mysterious elemental creatures in the form of a floating ball of fire; a working version was added to TDM in [http://www.thedarkmod.com/posts/announcing-the-release-of-tdm-2-05/ version 2.05]

=== Undeveloped creatures ===

These are creatures that were contemplated for ''The Dark Mod'', but shelved due to various reasons.

As with all concepts, don't expect all of these to be developed into working AI. Some might be eventually added as the game grows and matures, but it's mostly down to the talent available for creating and testing new AI.

'''Animals'''
*'''''Ravens''''' - a partially made raven model [http://forums.thedarkmod.com/topic/16811-cats-and-dogs/page-2#entry375619 was mentioned] by Springheel in 2014
*'''''Ridable horses''''' - just a very rudimentary, rough-around-the-edges attempt to create the semblance of a ridable horse AI; you can see this almost forgotten idea in this [https://www.youtube.com/watch?v=dilAPQiIxo4 old test footage] (TDM being what it is, the inclusion of ridable horses is ''highly unlikely'')

'''Fantasy beasts'''
*'''''[[Belchers]]''''' - lizard-like or amphibian-like bipedal creatures, dwelling in caves and swamps; [[Concept Art and Fan Art Archive#Creatures|several model concepts]] and some [https://www.youtube.com/watch?v=nb1VyhVJbA0 old test footage], but development is currently in limbo
*'''''[http://forums.thedarkmod.com/topic/17417-new-monster-model-mantian/ 'Mantians']''''' - insectoid humanoids with a praying mantis appearance; an AI concept proposed by Plutonia in 2015
*'''''Strigis''''' - no known models or concept art, just a proposed idea; apparently a feminine creature with owl-like features (''Strix'' being the Latin moniker for forest owls, the ''Strigidae''; Greek and Roman mythologies have featured the ''[https://en.wikipedia.org/wiki/Strix_(mythology) strix]'' as a bird of ill omen or a feminine, lamia-like being, while ''striga''-s are also vampire-like female undead or witches in various Slavic folklore)
*'''''Spider Queen''''' - was worked on for pre-standalone TDM; the model was adapted from Doom 3's Vagary and so cannot be used in standalone for legal reasons. (Not to be confused with the spider queen in Window of Opportunity.)
*'''''Werebeasts''''' - effectivelly humanoid, bipedal werewolves (or werewolf-like creatures); there is a semi-finished, though highly buggy and not properly working AI model, and some [https://www.youtube.com/watch?v=dilAPQiIxo4 old test footage], but development is currently in limbo

'''Undead beings'''
*'''''[[Undead|Ghouls]]''''' - humanoid undead monsters, haunting long-abandoned city quarters or burial places. A ghoul adapted from a Doom 3 zombie was prototyped before TDM went standalone.

== Unique to FMs ==

This section lists examples of natural or supernatural creatures and beings (other than humans) that are unique to the individual Fan Missions made by individual FM authors.

Some of these tend to be eventually included in the core mod, if they get approved.

Some of the humanoid monsters in the core mod are rather easily derivable into new creatures. Animated skeletons are a good example. Several authors have added additional customised features to these beings in their FMs, such as making their skeletal bodies or parts of their bodies engulfed in creepy flames (e.g. ''The Rift'' by badccog, ''Volta II: Cauldron of the Gods'' by Kingsal).

=== ''A Night to Remember'' ===

This fan mission by Fieldmedic features spirits haunting a manor house at night time.

'''Spirits''' 
The ghosts haunting the manor house are relatively slow-moving, but highly dangerous to the player character if he remains in their proximity. As transparent, incorporeal beings, thay are invulnerable to arrows. Every single arrow will go through them, without any effect.

=== ''Requiem'' ===

This fan mission by moonbo features several custom AI adversaries, but the most prominent are a type of armed, shadowy spirits.

'''Spirits''' 
One of the major new enemy AIs in the mission are "shadow spirits". They patrol like normal guards or the undead revenants, but the main danger posed by them is their partial invisibility. Depending on the lighting conditions of a given area, they can turn effectivelly invisible (or ''barely'' visible), while in others, the outlines of their bodies become more readily apparent. The player character is required to exercise some patience and extra care while traversing spaces that are patrolled by these beings.

=== ''Volta II: Cauldron of the Gods'' ===

This fan mission by Kingsal features two new creature types, as well as a variation on an established creature.

'''Fantasy beasts''' 
The first type is a species of beast-like humanoids (beastmen) with yellowy glowing eyes, referred to as "beasts" on the FM's GUI. They come in two varieties: A beastman armed with a curved short sword, and a beastman armed with the same weapon and a bundle of simple javelins. The latter is a ranged unit, akin to a typical TDM archer, though it uses a throwing weapon.

'''Elementals''' 
The second type is a will-o'-the-wisp. It slowly flies around a local area, illuminating the spaces below it in the process. It's a harmless being, it does not take any offensive or defensive action against the player, and is invulnerable. The only danger the little flying wisp poses to the player character is exposing the player's hiding place with light, especially if the player only relies on shadow cover and doesn't have some physical cover between him and the enemy AI in the mission.

'''Undead beings''' 
One old abandoned complex appearing in the mission is patrolled by skeletal undead engulfed in flames.

== See also ==

*[http://forums.thedarkmod.com/topic/14558-monsters/ Monsters] - General older forum discussion on monsters and their use in TDM.
*[http://forums.thedarkmod.com/topic/16833-mythical-creatures/ Mythical creatures] - General older forum discussion on the more fantastical creatures included or includable in TDM.
*[http://forums.thedarkmod.com/topic/15132-a-suggestion-vampires-within-the-lore/ A suggestion: Vampires within the Lore] - A creature idea proposed by LordPariah in 2013.
*[http://forums.thedarkmod.com/topic/18143-any-thoughts-on-adding-a-burrick/ Any thoughts on adding a Belcher ?] - Most recent discussion (2017) on the proposed "Belcher" creatures, with some links to older development discussions about the same topic.
*[http://forums.thedarkmod.com/topic/14066-needed-for-standalone-animated-werebeast/ Needed for Standalone: Animated Werebeast] - Discussion documenting the gradual development of the werebeast concept's current iteration for the game.
*[http://forums.thedarkmod.com/topic/19191-werebeasts-or-beastmen/ Werebeasts or Beastmen?] - Discussion answering a newbie question about these types of creatures.

[[Category:Universe]]

User:VanishedOne

2019-08-23T20:02:23Z

VanishedOne: /* Material shaders */

VanishedOne's notes and queries.

== Stim/Response ==
{| border="1"
!bgcolor=#d0d0e0 width="20%"|Type
!bgcolor=#d0d0e0 width="40%"|Comment in tdm_stim_response.script
!bgcolor=#d0d0e0 width="40%"|My notes

|-
|STIM_FROB
|Frobbed
|The Response to apply STIM_FROB won't work everywhere the dedicated frob Response will (only the latter collects loot).

|-
|STIM_FIRE
|Fire
|

|-
|STIM_WATER
|Water
|

|-
|STIM_DAMAGE
|damages target
|AI and the player have a STIM_DAMAGE Response to make this the case. It's not a response to ordinary damage (though a script object could listen for SIG_DAMAGE).

|-
|STIM_SHIELD
|protects against arrows or physical blows
|Used? Usable?

|-
|STIM_HEALING
|heals target
|The player has a Response to this; AI, by default, don't.

|-
|STIM_HOLY
|holy is applied
|Undead use a special script to get the damage def. from the source (usually a holy water arrow result); without one, there's no effect.

|-
|STIM_MAGIC
|Magic is being used
|Used anywhere? What's the purpose of this one? (From Thief's MagicZapStim?)

|-
|STIM_TOUCH
|triggered if touched
|Couldn't get a Response to fire on ordinary collisions, or on entering brush triggers. Maybe it's meant to be used as a collision stim.

|-
|STIM_KNOCKOUT
|target is knocked out
|AI/heads (including the player head) inherit a Response to this as standard to enable it to knock AI out, but the blackjack presumably uses a non-S/R mechanism for hit-cone-dependent knockouts.

|-
|STIM_KILL
|target is killed
|AI don't have a Response to this as standard. No luck activating Responses through death by normal means.

|-
|STIM_RESTORE
|target is restored
|What does this mean, if not the same as STIM_HEALING?

|-
|STIM_LIGHT
|triggered by light
|[http://forums.thedarkmod.com/topic/15713-stim-light/] Testing revealed no special handling (and 'use bounds' doesn't work with light volumes; presumably if a light has a model it'll use that).

|-
|STIM_SOUND
|triggered by sound
|Testing with a speaker revealed no special handling. (What about AI-audible soundprop?)

|-
|STIM_VISUAL
|visual contact
|Handled in code

|-
|STIM_INVITE
|can be used to trigger special behaviour (like a stool can invite an AI to sit down)
|Probably related to this idea from 2005: [http://forums.thedarkmod.com/topic/864-list-of-stim-response-animations/]

|-
|STIM_READ
|Can be read
|Used?

|-
|STIM_RANDOM
|Random response is selected (does this make sense?)
|Whether it was meant to fire any of the entity's Responses by random selection, or one of its Responses to this stim, I'm not sure this works (but the latter case can be taken care of by enabling 'Random Effects' on any Response).

|-
|STIM_TIMER
|Timer has been triggered.
|Used?

|-
|STIM_COMMUNICATION
|Communication vocalization
|Handled in code

|-
|STIM_GAS
|Gas arrows / mines
|

|-
|STIM_TRIGGER
|Entity "activation" stim
|

|-
|STIM_TARGET_REACHED
|Can be emitted if the endposition (e.g. by using an effect_moveToPosition) is reached
|Emitted to what?

|-
|STIM_PLAYER
|The "player" stim
|Radial stim on the player

|-
|STIM_FLASH
|The flashbomb stim
|

|-
|STIM_BLIND
|A "blind" stim that blinds the actor (this is stronger than a FLASH stim, no visibility is needed)
|

|-
|STIM_MOSS
|stim from moss arrows (e.g., for dampening window shattering)
|func_fractures come with a Response that calls breakable_glass::on_moss_stim (in tdm_breakable_glass.script)

|}

----

Is the magnitude of collision stims affected by velocity/force of collision, as reportedly in the Dark Engine?

Are these (in Response.h) used?

* How much damage must be applied for this response?
*/
float m_MinDamage;
/**
* No more than this.
*/
float m_MaxDamage;

== Models ==

'looks like Doom3 can load FLT models, which seem to be quite terrain specific. Might be something to look into if anyone has copious free time.' [http://forums.thedarkmod.com/topic/12155-how-do-you-guys-do-terrain/#entry246974]

A couple of D3BFG FX decls refer to .ips models (itemspawn.fx - model "itemrespawn.ips"; berserkspawn.fx - model "berserkrespawn.ips"). Maybe another development relic like the .particle extension?

Custom vertex normals usable in ASE but not LWO? [http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=422334][http://forums.thedarkmod.com/index.php?/topic/19426-exporting-models-from-blender-into-tdm/&do=findComment&comment=427049]

== AFs ==

Keywords not in [https://www.iddevnet.com/doom3/afs.html]:

''in settings:'' 
model (same as mesh?) 
noMoveTime 
noMoveTranslation 
noMoveRotation 
minMoveTime 
maxMoveTime 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask

''in body sections:'' 
contents (solid, body, corpse, playerclip, monsterclip) (clipping for moveables applied automatically?) 
clipMask 
mod (orientation, position, both) -- 'joint mod' 
inertiaScale 
frictionDirection 
contactMotorDirection 
('custom' model type for bodies isn't actually implemented.)

fixed - constraint type, includes: 
body1 
body2

slider - constraint type, includes: 
body1 
body2 
friction 
axis

== Animations ==

"enable_death_anim" spawnarg to use an anim called 'death' before going into ragdoll: [http://forums.thedarkmod.com/index.php?/topic/16523-solved-death-animation-before-ragdolls/&do=findComment&comment=354063]

== LOD ==

Comment in Misc.cpp: 'idAnimateds are the only class allowed to simply still their md5mesh as a LOD optimization, which they do by setting "model_lod_N" to the special value "be_still". They can also swap in another animated model, or a static FS model.'

== Textures ==

'D3's folder depth limitation for DDS files. You cannot have DDS files more than 5 folders deep... - D3 just doesn't want that, only the id people know why this unfortunate limit is there in the first place.' [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/page-8#entry185663] (Does this limit remain?)

== Material shaders ==

Stuff not in [https://www.iddevnet.com/doom3/materials.php] (including TDM's additions):

xrayRenderMap -- some code support from RoE may be missing (cf. Entity.cpp, BrittleFracture.cpp...). Perhaps TDM was built on [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/game /neo/game] instead of [https://github.com/TTimo/doom3.gpl/tree/aaa855815ab484d5bd095f347163194ac569abcc/neo/d3xp /neo/d3xp]. What's left can create a subview that skips some surfaces, e.g. there's an AI it can make bald, but the rules are unclear (some bodies just turn invisible, some don't) and I think "skin_xray" and "skin_head_xray" spawnargs may be broken. (Also D3BFG has a base/_common/generated/images/textures/sfx/xrayblend#__0200.bimage for which there's no apparent equivalent.)

portalRenderMap -- disabled at tr_subview.cpp line 790. Still appears in textures/smf/portal_sky

vertexParm2, stereoeye left/right -- not in TDM. Seems to be something id added to D3 BFG. [https://github.com/id-Software/DOOM-3-BFG/blob/master/neo/renderer/Material.cpp]

shadowDraw -- appears in D3's shaderdemos/shadowDrawLight in shaderDemo.mtr, but presumably leftover from an earlier stage of development. Would have been used in a stage of a light material to make that stage 'drawn on the shadows'. (It's listed in [https://modwiki.dhewm3.org/Stage_material_keywords_%28Prey%29] so maybe it survived in Prey?)

glasswarp -- removed. [http://bugs.thedarkmod.com/view.php?id=3868][http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355546] Heathaze program stages are used instead.

texgen normal -- disabled. (Apparently id's code had it generating a warning, similar to the unused glasswarp implementation. [http://forums.thedarkmod.com/topic/15178-tdm-engine-development-page/page-7#entry355264])

suppressInSubview -- global; appears occasionally in D3/RoE materials. Probably does what it says and hides surfaces in remote/mirror views, but I haven't tested.

screen -- stage keyword; appears in D3/RoE's textures/smf/window_scratch, and in TDM's portal_sky. Projects to screen instead of surface co-ordinates?

screen2 -- same as screen? Code comment: 'duzenko: treated by renderer same as TG_SCREEN, simplified'

name -- stage keyword. Code comment: 'BSM Nerve: Added for stage naming in the material editor'

portalSky -- as distinct from sort portalSky.

'New _currentDepth global image accessible by any shader. Unlike _currentRender, using this keyword in a material file does not delay the shader being drawn.
New ignoreDepth material file keyword. Prevents the shader being clipped by solid geometry.' -- [http://bugs.thedarkmod.com/view.php?id=3877]

'Added new material flag: sort afterfog
Applied it to material textures/particles/dustcloud and that seems to fix the fog overdraw.
This only works well for ambient-only materials, that weren't fogged before, like the waterfall in the test map.' -- [http://bugs.thedarkmod.com/view.php?id=4685#c9727]

islightgemsurf [http://bugs.thedarkmod.com/view.php?id=4379#c8359]

withAudio -- parameter added to videoMap [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

cubicLight, ambientCubicLight -- [http://bugs.thedarkmod.com/view.php?id=3881]
lightFalloffCubeMap, makeIrradiance() -- [http://forums.thedarkmod.com/topic/19147-parallax-corrected-cubemaps/#entry413520]

shadowmapOffset -- global keyword. Obviously a shadowmap tweak, but seems to be undocumented so far.

ambientRimColor -- [http://forums.thedarkmod.com/topic/19669-rim-lights/] Presently global; unclear whether we'll get it as a stage keyword, and whether the global version will remain if we do.

----
I'm coming to doubt that masks work in light-interactive stages. (Unsure about maskDepth.)

----
Do we have `sort underwater`? Seen [http://forums.thedarkmod.com/topic/15876-proper-realistic-moving-water/#entry334390 here] but not in idDevNet docs. (Maybe a mix-up with Quake 3 or ET:QW?)
----
noFog used to do nothing except during dmap with lightCarve -- [http://bugs.thedarkmod.com/view.php?id=3662] -- but now see [http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432862],[http://forums.thedarkmod.com/topic/19774-beta-testing-207/page-9#entry432873]
----
Is [http://forums.thedarkmod.com/topic/6505-re-did-broadheadagain/page-2#entry128468 this] how the hardwood surface type differs from regular wood? -- No: [http://bugs.thedarkmod.com/view.php?id=1421#c3251][http://bugs.thedarkmod.com/view.php?id=1422#c3252]

----
'rgb parameters work on cubemap stages ONLY when there are no diffuse/bumpmap/specular map blending stages set on the material' [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-5#entry388559]

Under these conditions, vertexColor has an effect but inverseVertexColor seems to have the exact same effect.
----
ignoreAlphaTest appears not to work on light-reactive stages.
----

In my experience the following can't be used with light interactions:
* Surfaces altered by deforms. (All non-particle deforms? Does TDM even use 'deform eyeball'?) But turbulent is at least partly compatible with light-interactive bump/specular. Others...?
* Particles spawned from surfaces (except that the simple ambient can add colour to them).

----
deform eyeball -- [http://idtechforums.fuzzylogicinc.com/index.php?topic=595.0]
----
clamp keywords: if materials look fine in DR but warped or invisible in TDM (e.g. for hinge decals), move the control points in the Texture Tool so the top-left is at 0,0. This seems reliable on patches. On brushes, I'm not sure clamp/zeroclamp/alphazeroclamp is reliable at all.
----
'The "add" image program only works with uncompressed textures.' [http://forums.thedarkmod.com/topic/14394-apples-and-peaches-obsttortes-mapping-and-scripting-thread/page-14#entry395180] I think this may be true of other image program functions too.
----
It seems "soundmap" gives bars for any string token except "wavelength". "soundmap" alone is an error.
----
What's the nodrop surface parameter for (in textures/common/nodrop)? Same as [http://tremap.xtr3m.net/__Games/Xreal/Manual_Shader_1/ShaderManual.htm#nodrop]? Yes, apparently -- comment from D3 assets: 'nodrop is a volume modifier that is tested before dropping items, used to keep items from cluttering up death pits'
----
id's cushion material is 'solid to movement', TDM's is set nonsolid.
----
Do blood decals still use this hack? [http://forums.thedarkmod.com/topic/11987-ocns-questions-on-tdm-editing/#entry239047]
----
'The "enhanced" interaction shader derives the glossiness part from the color-values of the specularmap, which were normally just driving the specular strength as you mentioned. The non "enhanced" shader does not do this and uses a preset gloss value instead.' [http://forums.thedarkmod.com/index.php?/topic/11893-ungoliants-mapping-questions/page/14/&tab=comments#comment-333485] (Do the GLSL shaders replicate this?)
----

TDM macros: [http://bugs.thedarkmod.com/view.php?id=3121]

PARTICLE_MACRO:

noselfShadow
noShadows
translucent
discrete
nonsolid
noimpact

GLASS_MACRO:

noselfShadow
noShadows
translucent
twosided

TWOSIDED_DECAL_MACRO:
discrete
nonsolid
noimpact
polygonOffset 1
noShadows
sort decal
noselfShadow
noShadows
translucent
twosided
(Why translucent?)

== ShaderParms ==

{| border="1"
!bgcolor=#d0d0e0 width="5%"|Number
!bgcolor=#d0d0e0 width="20%"|Alias (RenderWorld.h)
!bgcolor=#d0d0e0 width="10%"|Alias in tdm_defs.script
!bgcolor=#d0d0e0 width="55%"|My notes

|- style="vertical-align:top;"
|0
|SHADERPARM_RED
|✓
|

|- style="vertical-align:top;"
|1
|SHADERPARM_GREEN
|✓
|

|- style="vertical-align:top;"
|2
|SHADERPARM_BLUE
|✓
|

|- style="vertical-align:top;"
|3
|SHADERPARM_ALPHA
SHADERPARM_TIMESCALE
|✓
✓
|Contra [[List_of_shaderParm_variables]], may be set > 1 by LOD fading. 
Read by lights on spawn.

|- style="vertical-align:top;"
|4
|SHADERPARM_TIMEOFFSET
|✓
|Set on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Lights set this to -MS2SEC(gameLocal.time) on turning on, when they break, and on spawn if shaderParm4 isn't set in spawnargs.

|- style="vertical-align:top;"
|5
|SHADERPARM_DIVERSITY
|✓
|Programmer comment: 'random between 0.0 and 1.0 for some effects (muzzle flashes, etc)' 
Used for particle randomisation ([http://bugs.thedarkmod.com/view.php?id=4132#c7504] [http://bugs.thedarkmod.com/view.php?id=4132#c7506]; see also [http://forums.thedarkmod.com/topic/16710-particle-request-candle-smoke/page-3#entry359521]) 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964].

|- style="vertical-align:top;"
|6
|
|
|

|- style="vertical-align:top;"
|7
|SHADERPARM_MODE 
SHADERPARM_TIME_OF_DEATH
|✓ 
✓
|Programmer comment: 'for selecting which shader passes to enable' 
Security camera: [[#Security_camera|q.v.]] 
Programmer comment: 'for the monster skin-burn-away effect enable and time offset' 
Toggled on func_static activation [http://forums.thedarkmod.com/topic/17308-epis-many-questions-thread/page-7#entry413964]. Set to 1 when a light breaks.

|- style="vertical-align:top;"
|8
|SHADERPARM_MD5_SKINSCALE
SHADERPARM_MD3_FRAME
SHADERPARM_BEAM_END_X
SHADERPARM_SPRITE_WIDTH
SHADERPARM_PARTICLE_STOPTIME
| 
 
 
 
✓
|Programmer comment: 'for scaling vertex offsets on md5 models (jack skellington effect)'
[http://forums.thedarkmod.com/topic/18643-md3-models/] 
Programmer comment: 'for _beam models' 
No effect on deform sprite patch; maybe its model isn't _SPRITE? 
Programmer comment: 'don't spawn any more particles after this time' 
AI script event shrivel(time): 'Modifies shaderparm 8 from 1.0 to 0.5 over time (will return after multiple frames). Not used in Doom 3.' [https://www.iddevnet.com/doom3/script_ai.php] Is this what SHADERPARM_MD5_SKINSCALE is about? Setting parm8 to nonzero on an AI caused wild glitching in the vertex positions when I tried to look at it: is this just broken or do the materials need something special? See [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L325], [https://github.com/id-Software/DOOM-3/blob/master/neo/renderer/Model_md5.cpp#L257].

|- style="vertical-align:top;"
|9
|SHADERPARM_MD3_LASTFRAME
SHADERPARM_BEAM_END_Y
SHADERPARM_SPRITE_HEIGHT
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|10
|SHADERPARM_MD3_BACKLERP
SHADERPARM_BEAM_END_Z
|
|[http://forums.thedarkmod.com/topic/18643-md3-models/]

|- style="vertical-align:top;"
|11
|SHADERPARM_BEAM_WIDTH
|
|Luckily it's unlikely someone would want a frobable func_beam

|}

_SPRITE should behave like deform sprite according to code comments ('A simple sprite model that always faces the view axis.' -- Model_sprite.cpp), but in my tests, on an idStaticEntity it faced the reverse of the entity's direction, even with no "angle" spawnarg. (Whereas _BEAM worked as expected.) Using a deform sprite material (setting materials via a wildcard skin) overrides this but stops the aspect ratio changing: you can use the parms for scaling but the sprite can't change shape any more.

== Megatextures ==

The idea of megatexture channels as used in ETQW seems to be just appearing in the available code: Megatexture.h has

static const int MAX_MEGA_CHANNELS = 3; // normal, diffuse, specular

but this variable doesn't actually seem to be used. D3's shaderDemos/megaTexture applies the megatexture as blend gl_one, gl_zero. Version 2 of the D3 megatexture mod instead applies it as blend filter (with a regular texture as a diffusemap).

== Lights ==

Do the image maps in foglight stages actually do anything (besides keeping the parser happy)? tdm_fogs/cloud_fog uses lights/spot01 instead of _fog, but nothing I've tried seems to make any visual difference.

Ditto for falloff images in foglights, as in fogs/pitFog_to_black.

This (from D3BFG's fogs.mtr) is how it's supposed to work:

// If you replace the default internal fog projection image with your own
// texture, make sure that the alpha starts at 0 in the center, reaches
// 255 at the borders, and is generally radially symetrical.
// The color channel can be left solid white, or it can have additional
// color changes with position.

Using images with alpha channels doesn't seem to make any difference, though.

----

Foglight alpha values from 0 to 1 have fixed behaviour distinct from the way foglights behave with alpha > 1. D3's fogs.mtr says the default is applied if alpha 'equals the default 1.0', but that's not the actual test. renderer/draw_common.cpp:

// if they left the default value on, set a fog distance of 500
if ( backEnd.lightColor[3] <= 1.0 ) {
a = -0.5f / DEFAULT_FOG_DISTANCE;

Foglights can only have one stage:

// assume fog shaders have only a single stage
stage = lightShader->GetStage( 0 );

renderer/RenderWorld_local.h:

// A portal will be considered closed if it is past the
// fog-out point in a fog volume. We only support a single
// fog volume over each portal.

Does forceShadows in foglight and blendlight materials work, as id's docs claim? My test suggested not.

Falloff images don't have to be monochrome.

== Particles ==

I don't think particle decls accept .mtr-style expressions like [http://forums.thedarkmod.com/topic/18893-is-it-possible-to-sync-a-particle-emitter-to-a-light-shader/#entry406831] suggests, but the parser does check for table names. You pass the table name (without []) as the parameter for speed, rotation, size or aspect, and what I think happens is that the table is used to change the particle over its lifespan in place of the usual 'from' and 'to' numbers, allowing more complex transitions. I'm not sure whether it's possible to use more than one table per decl, since I ran into 'can't integrate tables' errors.

''TDM additions:''

WorldAxis -- [https://bugs.thedarkmod.com/view.php?id=3950]

softeningRadius -- Presumably to tweak soft particles. Defaults to -2.0f, meaning 'auto' according to code comments.

/* Soft particles -- SteveL #3878
-2.0 is the value at initialization, meaning no user specification: "auto".
-1.0 means no change to old system: suppress soft particles, but allow modelDepthhack if specified.
0 means disable all softening for this stage, including modelDepthHack.
+ve value means apply soft particle effect, allowing overdraw up to the specified depth.
This is more flexible even when not using soft particles, as modelDepthHack
can be turned off for specific stages to stop them poking through walls.
*/

''Custom paths:''

const ParticleParmDesc ParticleCustomDesc[] = {
{ "standard", 0, "Standard" },
{ "helix", 5, "sizeX Y Z radialSpeed axialSpeed" },
{ "flies", 3, "radialSpeed axialSpeed size" },
{ "orbit", 2, "radius speed"},
{ "drip", 2, "something something" }
};

From framework/DeclParticle.cpp

orbit presumably should correspond to Spherical in editParticles, but that's broken; type "orbit" in manually instead. drip does work in the editParticles menu. Neither is available for selection in DR, and it can't read them.

if ( !token.Icmp( "customPath" ) ) {
src.ReadToken( &token );
if ( !token.Icmp( "standard" ) ) {
stage->customPathType = PPATH_STANDARD;
} else if ( !token.Icmp( "helix" ) ) {
stage->customPathType = PPATH_HELIX;
} else if ( !token.Icmp( "flies" ) ) {
stage->customPathType = PPATH_FLIES;
} else if ( !token.Icmp( "spherical" ) ) {
stage->customPathType = PPATH_ORBIT;
} else {
src.Error( "bad path type: %s\n", token.c_str() );
}

This, however, checks for a "spherical" (not "orbit") keyword, but has no "drip". PPATH_DRIP is defined in the header file and tested elsewhere, though.

== GLprogs ==

Frob highlight: 'The frob.vfp program is not active. This has been part of Rebb's frobhighlighting improvement project, but in the end we ran into an issue with TGA files (they ended up with a heavy green tint in-game, which (we think) is due to some sort of limitation in the closed source parts - can't remember exactly).' [http://forums.thedarkmod.com/topic/10129-tdm-commands-and-variables/#entry199639] See [http://forums.thedarkmod.com/topic/8747-tweaks-to-frob-highlight/#entry174954]

== FX ==

'In the vanilla code "trackorigin" will not work unless "fadeIn" or "fadeOut" is set too.' [http://idtechforums.fuzzylogicinc.com/index.php?topic=56.msg395#msg395] Bug remains in TDM: [http://bugs.thedarkmod.com/view.php?id=4653]

Decal splatting has a short vertical range. For FX called in frame commands, use bindto "origin". For func_fx, its origin should be < 8 units above the ground. Decals are randomly rotated and there seems to be no way to override that.

Does ignoreMaster work in singleplayer? (The fall of my AI test partner's ragdoll from the sky suggests not.)

idEntity *ignore_ent = NULL;
if ( gameLocal.isMultiplayer ) {
ignore_ent = this;
if ( fxaction.shakeIgnoreMaster ) {
ignore_ent = GetBindMaster();
}
}

== GUIs ==

Focus doesn't work in TDM: [http://forums.thedarkmod.com/topic/12987-interactive-gui-surface-question/?p=266445]

It looks as though GUIs can use tables, etc. like materials, as seen in D3's malfunction.gui:

windowDef Static {
//static overlay
rect 0 ,0 ,640 ,480
visible 1
background "gui/static"
matcolor 1, 1, 1, pdhalffade[ time * 0.001 ]
}

And test user variables in conditions (as in D3's sttp.gui and indeed TDM's [[Loading_Screen_Text]]).

== Sound ==

Stuff not in [https://www.iddevnet.com/doom3/sounds.php] (including TDM additions; passing over reverb, ordered, plain and onDemand, all marked no longer supported):

antiPrivate -- opposite of private, presumably

playonce

fromVideo -- [http://bugs.thedarkmod.com/view.php?id=4534] [http://wiki.thedarkmod.com/index.php?title=Cutscene_video_with_FFmpeg]

no_efx -- [http://bugs.thedarkmod.com/view.php?id=4688#c9812]

== Triggers ==

Patches can be used for triggers and 'there could be separate triggers to be walked into depending on which direction you are walking'. [http://forums.thedarkmod.com/topic/14459-location-system-newbie-questions/#entry304288]

'This is a trigger_relay with set of targets (items) which will be gived to the player when map will be loaded. All targets will be activated by Code. This trigger must have a "devmap" name.' 'trigger playtesting item gives, if we didn't get here from a previous level' 'the devmap key will be set on the first devmap, but cleared on any level transitions' [http://idtechforums.fuzzylogicinc.com/index.php?topic=631.msg6576#msg6576]

== Targets ==

target_setinfluence removed? (Maybe considered redundant with S/R or too D3/'demonic'-specific? Comparing [https://modwiki.xnet.fi/Entity_Listing_%28Doom_3%29#t] to the TDM entity list suggests a purge of even some quite generic entities may have occurred.) idTarget_SetInfluence still exists so it can be recreated, but may be bugged in TDM [http://forums.thedarkmod.com/topic/10680-kalwins-questions/]. Can crash TDM on map load if e.g. targetted by worldspawn. D3 usage: [http://www.moddb.com/games/doom-iii/tutorials/creating-target-setinfluences]; D3 def here: [https://github.com/DanielGibson/d3-base-assets/blob/master/sabase/def/targets.def]

== PortalSky ==

Game_local.h --

enum {
PORTALSKY_STANDARD = 0, // classic portalsky
PORTALSKY_GLOBAL = 1, // always following portal sky
PORTALSKY_LOCAL = 2, // following portal sky from a spot

Misc.cpp --

if ( spawnArgs.GetInt( "type" ) == PORTALSKY_GLOBAL )

gameLocal.portalSkyScale = spawnArgs.GetInt( "scale", "16" );

[http://forums.thedarkmod.com/topic/13442-implementing-3d-skyboxes-that-follow-the-player/page-5#entry311721], [http://bugs.thedarkmod.com/view.php?id=3108]

== Security camera ==

idSecurityCamera::Pain() refers to an "fx_damage" spawnarg not documented in the entityDef. Similarly, idSecurityCamera::Killed() refers to an "fx_destroyed" spawnarg.

idSecurityCamera::SetAlertMode() looks to have code to update SHADERPARM_MODE (parm7), where

enum { SCANNING, LOSINGINTEREST, ALERT, ACTIVATED }

suggesting it's possible to have something like the T2 Watchers' colour-changing lights.

== Misc. ==

What is/was trigger_air? (textures/common/trigair) There's no such entity def., even among the commented-out ones in triggers.def. Maybe related to the commented-out info_vacuum in d3_junk.def?

`knockout` spawnarg on atdm:weapon_base ('If set to true, a hit with that weapon knocks the AI out') -- working/used? The blackjack instead uses a `knockout` spawnarg in its melee def. (melee_blackjack_ovr): compare atdm:damage_moveable, which also has a `knockout_power` spawnarg.

`inv_item_count` defined on atdm:playertool: used for anything? (Compare `inv_count`.)

Does [[Clipmodel contents spawnarg|clipmodel_contents]] still exist/work? -- Yes, as in atdm:blood_marker

$player1.replaceInvItem($some_inv_item, $null_entity) -- if $some_inv_item was simply placed in the world, the inventory icon will disappear if it was on the screen; if it entered the inventory via the shop, the icon will remain until cycled away from.

func_splat -- undocumented in the entityDef, "splatAngle" spawnarg can specify rotation. (I'm not sure the fade respects decalInfo. Decals seem to disappear after a fixed time even if there is no decalInfo.)

== Weather ==

"classname" "func_static"
"sr_class_1" "S"
"sr_radius_1" "0"
"sr_state_1" "1"
"sr_time_interval_1" "200"
"sr_type_1" "2"
"sr_use_bounds_1" "1"
"solid" "0"

Texture brushes of this entity with textures/common/collision and put them under your rain/snow patches so you can no longer carry a lit candle through a downpour.