4.7.9.0

CHANGELOG.md

@@ -1,4 +1,21 @@
 # This is an archive of changelog messages from `tfa_loader.lua`.
+## 4.7.9.0
+* Added throttling for attachments status request from server
+* Reworked loader
+* Updated Inter font to 4.1
+* Added batch attachments registration system to reduce Lua files count
+* Removed unnecessary attachments initialization calls on map load
+* Renamed tfa_envcheck convar to sv_tfa_envcheck since it's controlled by server
+* Removed microoptimization from SWEP:GetStatRaw, allowing it to work with tables from weapons.Get
+* Weapon type autodetection fixes (for weapons that do not have SWEP.Type explicitly defined)
+* Automatic spawnmenu subcategories generation based on weapon type (cl_tfa_subcategories_auto 1)
+* Color palettes/mixers in base settings are now foldable
+* Fix for crouching and sprinting with centered viewmodel
+* Aim progress FOV threshold, enabled by default for 2D scoped weapons
+* Slightly improved aim, sprint and inspect progress prediction
+* Various microoptimizations to frequently called hooks
+* Fixed SWEP:CanAttach (and relevant hooks) not receiving attachment ID on detaching
+
 ## 4.7.8.6
 * First deploy state is now networked (and saved properly with engine saves)
 * Projectile spread now function same as hitscan bullets

README.md

@@ -7,6 +7,7 @@
 - [Weapon Template](lua/tfa/documentation/tfa_base_template.lua) - reference for the main weapon Lua file with all values ([legacy template](lua/tfa/documentation/tfa_legacy_template.lua) is available for backwards compatibility reference)
 - [Melee Weapon Template](lua/tfa/documentation/tfa_melee_template.lua) - reference for melee-type weapons
 - [Attachment Template](lua/tfa/documentation/tfa_attachment_template.lua) - file name is the ID of attachment that goes into `SWEP.Attachments` table, place to `<your addon>/lua/tfa/att` folder
+- [Batch Attachments Template](lua/tfa/documentation/tfa_attbatch_template.lua) - for registering multiple attachments in a single file, to reduce Lua files. Place to `<your addon>/lua/tfa/attbatch` folder
 - [Animations Reference](lua/tfa/documentation/tfa_anims_template.lua) - list of animations that are used by the base
 - [Custom Hooks](lua/tfa/documentation/tfa_hooks_custom.lua) - list of [hooks](https://wiki.facepunch.com/gmod/hook.Add) added by the base for the addons intercompatibility
 - [Material Proxies](lua/tfa/documentation/tfa_matproxies.lua) - list of [material proxies](https://developer.valvesoftware.com/wiki/Material_proxies) added by the base

lua/tfa/documentation/tfa_attbatch_template.lua

@@ -0,0 +1,97 @@
+
+-- TFA Base Batch Attachment Registration Template by TFA Base Devs
+
+-- To the extent possible under law, the person who associated CC0 with
+-- TFA Base Template has waived all copyright and related or neighboring rights
+-- to TFA Base Template.
+
+-- You should have received a copy of the CC0 legalcode along with this
+-- work.  If not, see <http://creativecommons.org/publicdomain/zero/1.0/>.
+
+-- Place your file in addons/<YOUR ADDON NAME HERE>/lua/tfa/attbatch/<YOUR FILE NAME HERE>.lua
+-- These are loaded after regular lua/tfa/att folder, allowing to place base attachments there.
+
+if not TFA_ATTACHMENT_ISUPDATING then TFAUpdateAttachments(false) return end
+
+-- TFA.Attachments.RegisterFromTable(string id, table ATTACHMENT)
+TFA.Attachments.RegisterFromTable("your_att_id_here", {
+	TFADataVersion = 1, -- If it is undefined, it fallbacks to 0 and WeaponTable gets migrated like SWEPs do
+
+	-- Base = "base", -- Attachment baseclass, defaults to "base" attachment
+
+	Name = "Example Attachment",
+	ShortName = nil, -- Abbreviation shown on the bottom left of the icon, generated from name if not defined
+	Description = {
+		TFA.Attachments.Colors["+"], "Does something good",
+		TFA.Attachments.Colors["-"], "Does something bad",
+		-- Color(255, 255, 255), "bottom text",
+	}, -- all colors are defined in lua/tfa/modules/tfa_attachments.lua
+	Icon = nil, -- "entities/tfa_ammo_match.png" -- Full path to the icon, reverts to '?' by default
+
+	WeaponTable = { -- The place where you change the stats (CACHED STATS ONLY!)
+		["Primary"] = {
+			["Damage"] = 60, -- For example, you want to change SWEP.Primary.Damage value to 60
+			["ClipSize"] = function(wep, stat)
+				return wep.Primary_TFA.ClipSize_Override or stat * 1.5
+			end -- Stat functions support changing value dynamically (which is cached afterwards), SWEP.Primary_TFA contains original unchanged values
+		}
+	},
+
+	-- DInv2_GridSizeX = nil, -- DInventory/2 Specific. Determines attachment's width in grid.
+	-- DInv2_GridSizeY = nil, -- DInventory/2 Specific. Determines attachment's height in grid.
+	-- DInv2_Volume = nil, -- DInventory/2 Specific. Determines attachment's volume in liters.
+	-- DInv2_Mass = nil, -- DInventory/2 Specific. Determines attachment's mass in kilograms.
+	-- DInv2_StackSize = nil, -- DInventory/2 Specific. Determines attachment's maximal stack size.
+
+	--[[
+	-- Default behavior is always allow, override to change
+	CanAttach = function(self, wep)
+		return true
+	end,
+	]]--
+
+	--[[
+	-- These functions are called BEFORE stat cache is rebuilt
+	Attach = function(self, wep)
+	end,
+
+	Detach = function(self, wep)
+	end,
+	]]--
+
+	-- Attachment functions called from base
+	--[[
+	-- Called from render target code if SWEP.RTDrawEnabled is true
+	RTCode = function(self, wep, rt_texture, w, h)
+	end,
+	]]--
+
+	--[[
+	-- Called from FireBullets for each bullet trace hit; arguments are passed from bullet callback
+	CustomBulletCallback = function(self, wep, attacker, trace, dmginfo)
+	end,
+	]]--
+
+	--[[
+	-- Called before stencil sight reticle is drawn
+	PreDrawStencilSight = function(self, wep, vm, ply, sightVElementTable)
+		-- 3D rendering context from PostDrawViewModel
+		-- https://wiki.facepunch.com/gmod/3D_Rendering_Functions
+
+		-- return true -- to prevent SWEP:PreDrawStencilSight from being called
+		-- return false -- to stop reticle from drawing
+	end,
+	]]--
+
+	--[[
+	-- Called right after stencil sight reticle is drawn
+	PostDrawStencilSight = function(self, wep, vm, ply, sightVElementTable)
+		-- 3D rendering context from PostDrawViewModel
+		-- https://wiki.facepunch.com/gmod/3D_Rendering_Functions
+
+		-- return true -- to prevent SWEP:PostDrawStencilSight from being called
+	end,
+	]]--
+})
+
+-- and so on

lua/tfa/documentation/tfa_base_template.lua

@@ -549,6 +549,9 @@ SWEP.Secondary.OwnerFOV             = 70
 -- AKA IronViewModelFOV
 SWEP.Secondary.ViewModelFOV         = nil -- Defaults to 65. Target viewmodel FOV when aiming down the sights.
 
+SWEP.Secondary.OwnerFOVUseThreshold = nil -- true/false -- If enabled, OwnerFOV will be changed only past the threshold when aiming. Defaults to SWEP.Scoped value
+SWEP.Secondary.OwnerFOVThreshold    = nil -- 0 to 1 -- defaults to SWEP.ScopeOverlayThreshold (which is 0.875 by default)
+
 ----------------- Worldmodel related
 SWEP.WorldModel                 = "models/your/wmodel/path/here.mdl" -- Weapon world model path
 -- AKA Bodygroups_W