1. Post #1
    Needs more suspension.
    Dennab
    February 2006
    4,484 Posts
    Recently, the ACF developers have been active, and have instituted an entire line of ACF engines and gearboxes, in this thread, we'll show you how to properly utilize them.


    Overview:



    What is ACF?

    For those of you who don't know, ACF stands for Armored Combat Framework. It is a GMod addon that simulates ballistics and steel to form an advanced combat system. It's like GCombat, only more realistic. ACF has also been publicly available for quite some time; it's no longer exclusive. Links will be at the end of the post for serverside and clientside downloads.


    Down to business:
    Ok, so the thread is about engines and such, how do they work?

    It's very simple. ACF engines were created initially to solve the balance equation for armored vehicles. Tanks and the like operate on 3 standards, Firepower, Mobility, and Protection. Prior to acf engines, everything was powered by means of applytorque, or thrusters, or whatever. It's all very unrealistic.

    Engines however, solve that corner of the equation. ACF engines function like real engines- they have powerbands (gasoline and diesel!), rpm, power and torque outputs, the works. They even simulate flywheels! Engines in ACF are accurately rated in Kilowatts and Newton-meters (the most basic forms of energy and torque output). Engines calculate the entire weight of your contraption, and scale its performance accordingly. It's so parented stuff will be counted as actual load on the vehicle, it's all very clever. If your vehicle is underpowered, apply another engine, or a bigger engine, or lighten the vehicle!

    But it's not just engines that this includes; there's gearboxes as well. As engines range from gasoline to diesel types, gearboxes range from 4 speed setups to 6 speed setups, in the form of transaxial and inline gearboxes. There are also dual clutch versions for skid-steering!



    Ok, so what kind of engines does ACF sport?

    ACF currently contains 18 engines, all varying from inline 4s, inline 6s, and V8s (however V12s are on the way!). There are diesel and gasoline versions of each engine type, and each engine type has a set of 3 strengths of engine, small, medium, and large. Each engine has its own unique sound and characteristics.



    And the transmissions?

    Of course engines need some way of conveying their fiery, oily, spinning energy, so that's why ACF contains gearboxes as well. There are a few types of gearboxes, Transaxial, Inline, and dual-clutch. Transaxial gearboxes are like differentials with an attached gearbox, very basic. Inline gearboxes are for if your engine is transverse, and you need the power to be transferred in the same direction as the camshaft of the engine. Think of a front wheel drive car, it's like that.
    Dual-clutch doesn't mean they're flappy paddle F1 transmissions, it simply means they have individual brakes and clutches for each side of the transmission. Oh, did we mention that the gearboxes also contain the brakes? You can also even clutch them! Gearboxes do have automatic clutches though too, so you don't stall.

    Gearboxes also have torque limits, as in the amount of engine torque they can handle. ACF displays their rating, so be careful. You wouldn't use a 20 liter inline 6 with a small transmission, now would you? Gearboxes can handle multiple engines, and vice versa. Just be mindful of the clutch limitations!



    Ok, so how do I put this all together?

    ACF has its own linking tool, that you use by right clicking. You can attach your engines and wheels by a means of a driveshaft. But be careful, if the angle is too great, you won't be able to link things. For instance, you won't be able to link an engine to a gearbox that is too far to the right or left of the engine's output point, as per real life.
    It's very simple to link the components up- Just right click the engine, then the gearbox, and then line up the gearbox with some wheels, and link from the gearbox to the wheels. You can link as many wheels as you want as long as they don't overbear the driveshaft's angle limit. If you want to decouple anything, just hold E and right click the components in the order you linked them in.

    You'll also want to remember that driveshafts can break, so try to keep your driveshafts straight. If you hit something too hard, you could snap a shaft. If you do, just relink them!


    Some Dos and Don'ts:

    -Don't try to change engine or transmission weight, it will make them not work.
    -Due to Garry, you need to drag the sliders in the gearbox creation, don't manually type in numbers!
    -Remember that gearboxes have limitations, so be mindful of this! 6 speed transmissions are slightly less resilient than 4 speeds, too.
    -YOU CANNOT PARENT ENGINES OR TRANSMISSIONS; this is in place so you can't cheat and not have the actual mass of the mobility components. If you do, your vehicle won't move!
    -Remember that the gas engines have significantly higher powerbands, so you need to modulate the clutch accordingly. To take off, you'll need to smooth the clutch out to get going, especially with the smaller engines. You'll think to just use a diesel, but remember, gas engines offer better horsepower for speed.
    -Don't use super-low ratios, engines tend to freak out.
    Tips and Tricks:
    -If you want a reverse gear, just make one gear ratio a negative value!
    -If your vehicle doesn't go the right way, reverse the Final Drive ratio!
    -If your vehicle just groans and doesn't move, perhaps it's too heavy. Use the ACF Total Mass tool to find your vehicle's total weight. The average weight of a car is about 2 tons, or 2000kg, so be mindful!
    -If your vehicle just revs and doesn't move, or the rpm fluctuates, your clutch(es) are probably overburdened. Consider a bigger gearbox.
    -Diesel engines have low-end power, but poor horsepower. 6 speed transmissions often work well for heavy moving, so you can keep the power up all the time.
    -If your engine doesn't run, make sure the engine is linked to a gearbox, and active is enabled. This is a beta after all, so it has some bugs. A driveshaft might also be broken.
    -If you need 4 wheel drive or braking, consider powering a central drive wheel and advance ballsocketing the wheels to it, or you can adv bs the powered wheels to the non-powered wheels. Works either way!

    Important for controlling mobility components:
    Here are the values for various engine inputs/outputs:

    Throttle = 0 - 100
    Brake = 0 - 100 (brakes are often buggy, so only use variables between 0 and 20, or else they will spaz and do nasty things)
    Clutch = 0 -1 (you can still use interim variables, such as 0.5)
    Gear = 0 - 6 depending on 4 or 6 speed (0 is neutral, 1 is first gear, 2 is second, etc!)+

    Outputs:
    RPM = If you don't know what this is, then..
    Power = Power in Kilowatts (use google to convert to horsepower if you like!)
    Torque = Torque in Newton Meters
    Mass = You can use this output to calculate your vehicle's total mass, but make sure active on the engine is on!
    Physical Mass = Same thing as mass, except it excludes parented stuff.

    Remember that the wire Debugger tool is useful- you can use it to display what the engine or transmission is doing on your hud.

    Random Images!











    Installation

    It's all very easy, just make sure you follow these steps!

    For clients:

    Make a folder in your addons, and name it ACF. From there, make sure you have Tortoise SVN, right click the folder, and select SVN checkout.
    Put in this link: http://acf.googlecode.com/svn/branches/models, and hit ok.

    IMPORTANT! Make SURE you take the scripts & particles folder you downloaded in the ACF addon folder, and put them in your main gmod directory! Stuff will not make sound if you don't!

    For servers or playing in Singleplayer:

    Create a folder somewhere, and name it ACF. SVN checkout it with the link http://acf.googlecode.com/svn/. From there, it should download the whole svn.

    Now take the junk in the http://acf.googlecode.com/svn/trunk folder, and put it in a folder in your GMod addons called ACF, and put all the shit in it.



    You can get useful ACF tools by TGIFallen from this svn, it includes tools for acf that allow you to easily see armor and health ratings, as well as set armor thicknesses!
    http://tgifallen.googlecode.com/svn/trunk/Fallen's Build tools

    Be sure to put the scripts & particles folder in your main gmod directory, too.

    DO NOT INSTALL THE DEV FOLDER! IT IS DECREPIT AND BROKEN! It will break a lot of shit!

    Remember that this is an ongoing WIP, so stay updated! If you ever want to see what's going on with acf, just go here to see the revisions. Just click the changes link on the page!
    That's all for now! If you need any help or have questions, feel free to ask.
    Reply With Quote Edit / Delete Reply United States Show Events Winner x 11Funny x 4Informative x 1Late x 1Useful x 1 (list)

  2. Post #2
    I HAVE AN UNUSUALLY SMALL PENIS AND MY POSTS ARE TERRIBLE
    Whitefox08's Avatar
    June 2008
    3,059 Posts
    Love it, cant wait for improvement and additions.
    Reply With Quote Edit / Delete Reply Windows 7 United States Show Events Winner Winner x 1 (list)

  3. Post #3
    lazermaniac's Avatar
    January 2005
    86 Posts
    hi i am lazermaniac and i made all these models please validate my existance and stroke my ego by saying how amazing they are
    Reply With Quote Edit / Delete Reply Windows 7 Show Events Winner x 17Useful x 3Optimistic x 1Artistic x 1Funny x 1 (list)

  4. Post #4
    Needs more suspension.
    Dennab
    February 2006
    4,484 Posts
    :>
    Reply With Quote Edit / Delete Reply Windows XP United States Show Events Friendly Friendly x 1Dumb Dumb x 1 (list)

  5. Post #5
    Gold Member
    MrWhite's Avatar
    March 2010
    3,568 Posts
    hi i am lazermaniac and i made all these models please validate my existance and stroke my ego by saying how amazing they are
    Not a big fan of the V8 engine personally. It just feels too "racecar" for me to believe it could be a diesel. Good work on the inlines, though.


    Love the mod in general. I'll always still build thruster engines, but I'll definitely work with these, too.

  6. Post #6
    Gold Member
    mastfire's Avatar
    July 2008
    1,899 Posts
    is it possible to make more weapons or ammo types? Maybe having props devoted to tank making or have accessories to make it better like wheels etc.
    Reply With Quote Edit / Delete Reply Windows 7 United States Show Events Disagree Disagree x 4 (list)

  7. Post #7
    Needs more suspension.
    Dennab
    February 2006
    4,484 Posts
    no
    Reply With Quote Edit / Delete Reply Windows XP United States Show Events Agree Agree x 2 (list)

  8. Post #8
    this boggles my brain
    let me download it and figure shit out first.

  9. Post #9
    Gold Member
    mastfire's Avatar
    July 2008
    1,899 Posts
    any reason why?
    Reply With Quote Edit / Delete Reply Windows 7 United States Show Events Funny Funny x 1 (list)

  10. Post #10

    July 2008
    850 Posts
    any reason why?
    Because the point of playing sandbox is to be creative, and not to see the same tank 20 times made out of the same prefabricated parts like those phx jets?
    Reply With Quote Edit / Delete Reply Windows Vista United States Show Events Informative Informative x 1 (list)

  11. Post #11
    One Ear Ninja's Avatar
    November 2009
    2,114 Posts
    cool to see that acf is spreading around

  12. Post #12
    Gold Member
    MrWhite's Avatar
    March 2010
    3,568 Posts
    Hey, I was experimenting with a few engine configurations, and I was having trouble getting low ratios to play nice with the engine. The engine RPM would spike violently and the vehicle would end up bobbing up and down. Is this a common problem with this stuff or am I just missing something?

  13. Post #13
    Needs more suspension.
    Dennab
    February 2006
    4,484 Posts
    Yeah, really low ratios tend to do fucky shit. Kaf's working on fixing it.

  14. Post #14
    I HAVE AN UNUSUALLY SMALL PENIS AND MY POSTS ARE TERRIBLE
    Whitefox08's Avatar
    June 2008
    3,059 Posts
    this boggles my brain
    let me download it and figure shit out first.
    speak your feelings luke
    Reply With Quote Edit / Delete Reply Windows 7 United States Show Events Funny Funny x 1 (list)

  15. Post #15
    I wish I was as cool as Felix :)
    Apache249's Avatar
    April 2010
    7,772 Posts
    Aww nice! I'll make sure to test them out when I get the time. Are gas turbines on the way too?

  16. Post #16
    ~Tital~
    napalm_bomb's Avatar
    July 2009
    1,194 Posts
    I failed to link them properly then proceeded to exit the game and take a shit.
    Reply With Quote Edit / Delete Reply Windows Vista United States Show Events Informative Informative x 5Dumb Dumb x 1 (list)

  17. Post #17
    Sorry for reviving this thread but i have a big question. I don't use to play sandbox because my patience is almost inexistant but i have 2 questions about this:

    1- How can I aim the guns with the mouse. I mean, E2 code to use or something like that.

    2- How can i turn. Do i have to use double clutch and break one side while throtteling the other one?


    Thanks and i hope i don't get a ban for this :\
    Reply With Quote Edit / Delete Reply Windows 7 Netherlands Show Events Optimistic Optimistic x 1 (list)

  18. Post #18
    About as smart and adept as a pile of turds
    oakman26's Avatar
    January 2010
    3,466 Posts
    Wouldn't you rotate the wheel?

  19. Post #19
    Needs more suspension.
    Dennab
    February 2006
    4,484 Posts
    Sorry for reviving this thread but i have a big question. I don't use to play sandbox because my patience is almost inexistant but i have 2 questions about this:

    1- How can I aim the guns with the mouse. I mean, E2 code to use or something like that.

    2- How can i turn. Do i have to use double clutch and break one side while throtteling the other one?


    Thanks and i hope i don't get a ban for this :\
    for mouse aim, you need some kind of e2 aim that uses shootpos or aimpos, they're very common and you could use this old tank chip (however it doesn't have support for acf engines, so just use the aiming portion of it)

    as for steering, you need to brake and clutch one side of a dual clutch gearbox.

  20. Post #20
    Gold Member
    MrWhite's Avatar
    March 2010
    3,568 Posts
    After updating my SVN, I'm still not getting those 1-speed transmissions you added. Did I interpret something?

  21. Post #21
    MrBuBB13s's Avatar
    November 2010
    43 Posts
    How do you get the missiles and bombs? They're in the browse menu but there is no actual tool to spawn them.
    Reply With Quote Edit / Delete Reply Windows 7 United Kingdom Show Events Disagree Disagree x 1 (list)

  22. Post #22
    for mouse aim, you need some kind of e2 aim that uses shootpos or aimpos, they're very common and you could use this old tank chip (however it doesn't have support for acf engines, so just use the aiming portion of it)

    as for steering, you need to brake and clutch one side of a dual clutch gearbox.
    For the turn think it works very badly. It turns very slowly

    For the aim i tried the r2 someone suggested me but i dunno how to use it even after reading the commjnets :S

  23. Post #23
    One Ear Ninja's Avatar
    November 2009
    2,114 Posts
    How do you get the missiles and bombs? They're in the browse menu but there is no actual tool to spawn them.
    They aren't implemented with the newer version of ACF

  24. Post #24
    neolite's Avatar
    November 2007
    88 Posts
    Excuse me for asking this stupid question, but i just came back after 1 year of not playing GMOD. So, i'm not a WIRE technician, but how do i solve the gear problem? I can't really figure it out, because i want a toggle system, where you only have 2 buttons, up and down, and it toggles once it's pressed. So if i press Up, it goes into gear 1, and stays there. Then when pressing up again, it locks into gear 2 and so on. I can't really figure it out, how to write that in E2, anyone here who could help me?

  25. Post #25
    xXsparrowXx's Avatar
    December 2011
    5 Posts
    <snip>.

  26. Post #26
    Dennab
    June 2010
    2,040 Posts
    I've noticed that in ultra low gears clutch-and-brake steering is more like clutch-and-brake-gradually-drift-ever-so-slightly-to-one-side.

  27. Post #27
    Gold Member
    MrWhite's Avatar
    March 2010
    3,568 Posts
    That or, once the engine hits its powerband, the vehicle burps and the engine hits 12k rpm.
    Reply With Quote Edit / Delete Reply Windows 7 United States Show Events Funny Funny x 2 (list)

  28. Post #28
    Dennab
    June 2010
    2,040 Posts
    That or, once the engine hits its powerband, the vehicle burps and the engine hits 12k rpm.
    puttputtputtputtputtputtputttputtBRRAAAAAHBRAAAAAB RAAAAAABRAAAAAAAAAAAAAAAHHHH
    Reply With Quote Edit / Delete Reply Windows 7 United States Show Events Agree Agree x 3Funny Funny x 2 (list)

  29. Post #29
    Gold Member
    superstepa's Avatar
    June 2009
    8,947 Posts
    Is there any sort of the official website or blog or even twitter of the devs?
    Reply With Quote Edit / Delete Reply Windows 7 Russian Federation Show Events Funny Funny x 1 (list)

  30. Post #30
    Tumornator
    Kebab's Avatar
    August 2010
    1,272 Posts
    I have no idea what I'm doing. My engines are being awfully noisy, the gearboxes are apparently doing absolutely nothing and I'm not seeing any wheel-related movement. :V

    Can anybody direct me to some sort of guide that goes through in steps how to set it up fully?

    Please help I'm stupid.
    Reply With Quote Edit / Delete Reply Windows 7 Iran, Islamic Republic of Show Events Agree Agree x 1Informative Informative x 1 (list)

  31. Post #31
    Needs more suspension.
    Dennab
    February 2006
    4,484 Posts
    fear not, i will make some instructional vids
    Reply With Quote Edit / Delete Reply Windows 7 United States Show Events Informative Informative x 2Friendly Friendly x 1 (list)

  32. Post #32

    March 2012
    94 Posts
    I don't get it work on my linux debian server

    I tried ow over 2 hours.. no success.

    I created a dir "ACFSvn" and "ACF" I checkout to ACFSvn. Got "trunk" and "branches". I took content from branches/models (lua, materials, co.) to "ACF". I took the content of trunk to "ACF" and override some files that are already exist.

    But not working I get errors when I try to chooce something. Serverconsole prints this

    Code:
    Didn't find entity duplicator records
    [addons/ACF/lua/weapons/gmod_tool/stools/acfmenu.lua:63] attempt to index field '?' (a nil value)
    [addons/ACF/lua/weapons/gmod_tool/stools/acfmenu.lua:63] attempt to index field '?' (a nil value)
    [addons/ACF/lua/weapons/gmod_tool/stools/acfmenu.lua:63] attempt to index field '?' (a nil value)
    [addons/ACF/lua/weapons/gmod_tool/stools/acfmenu.lua:63] attempt to index field '?' (a nil value)
    [addons/ACF/lua/weapons/gmod_tool/stools/acfmenu.lua:63] attempt to index field '?' (a nil value)
    Didn't find entity duplicator records
    Didn't find entity duplicator records
    Client

    Code:
    [ACF\Shared\ACFGunList.lua:145] attempt to call global 'ACFGunGUICreate' (a nil value)

  33. Post #33
    Needs more suspension.
    Dennab
    February 2006
    4,484 Posts
    linux doesn't work with acf at the moment, i'm going to fix that though. it's just a case sensitivity problem.

  34. Post #34
    Frankess's Avatar
    November 2005
    511 Posts
    All you need to do is change in lua folder every name of file to lowercase and then in lua/autorun/acf_globals.lua replace everything from line 37 to 67 with that:
    Code:
    AddCSLuaFile( "acf_globals.lua" )
    AddCSLuaFile( "acf/client/cl_acfballistics.lua" )
    AddCSLuaFile( "acf/client/cl_acfmenu_gui.lua" )
    
    AddCSLuaFile( "acf/client/cl_acfballistics.lua" )
    AddCSLuaFile( "acf/client/cl_acfmenu_gui.lua" )
    
    if (SERVER) then
    
    	include("acf/server/sv_acfbase.lua")
    	include("acf/server/sv_acfdamage.lua")
    	include("acf/server/sv_acfballistics.lua")
    	
    elseif (CLIENT) then
    
    	include("acf/client/cl_acfballistics.lua")
    	--include("acf/client/cl_acfmenu_gui.lua")
    	
    end
    
    include("acf/shared/rounds/roundap.lua")
    include("acf/shared/rounds/roundaphe.lua")
    include("acf/shared/rounds/roundhe.lua")
    include("acf/shared/rounds/roundheat.lua")
    include("acf/shared/rounds/roundhp.lua")
    include("acf/shared/rounds/roundrefill.lua")
    include("acf/shared/rounds/roundfunctions.lua")
    
    include("acf/shared/acfgunlist.lua")
    include("acf/shared/acfmobilitylist.lua")
    include("acf/shared/acfsensorlist.lua")

  35. Post #35

    March 2012
    94 Posts
    Well if I do I get new error

    Code:
    [@gamemodes\sandbox\gamemode\spawnmenu\controlpanel.lua:99] ControlPanelBuildFunction Error: [@lua\includes\extensions\vgui_sciptedpanels.lua:166] vgui.Create: Error when calling 'PANELTABLE':Init ([@ACF\Client\cl_ACFMenu_gui.lua:59] bad argument #1 to 'pairs' (table expected, got nil))
    I am sure cause he couldn't find.. taht sux. I have to change every file to lowercase?

  36. Post #36
    Frankess's Avatar
    November 2005
    511 Posts
    Yes, in lua folder. Including names of folders.

  37. Post #37

    March 2012
    94 Posts
    I get still the same error
    I even changed in
    /addons/ACF/lua/weapons/gmod_tool/stools/acfmenu.lua
    at line 39 to lowercase like this
    local pnldef_ACFmenu = vgui.RegisterFile( "acf/client/cl_acfmenu_gui.lua" )
    but same

  38. Post #38
    Frankess's Avatar
    November 2005
    511 Posts
    I own Debian6 server and ACF works well there. You have two options, you can wait for an update to ACF which will do this for you or you can remove ACF, download it again (You don't need to join both folders. We get them already combined) and do what I wrote above. After that copy the code which I already changed for you and replace with it lines between 37 and 67. Finally, check that all folders and files agree with paths in the pasted code.

  39. Post #39

    March 2012
    94 Posts
    Well I guess I have to wait. I mean its not difficult to change to lowercase. I tried how you said with redownload

    I even found in roundsdir and other dirs in the lua files "AddCSLuaFile"
    it needed to be lowercase or client wouldn't download the files (because of file not found).

    Now I get agian "attempt to call global 'ACFGunGUICreate' (a nil value)". I do not find more things.. what I can change.. No Idea anymore.

    I will just wait for the next release

  40. Post #40
    bitter146's Avatar
    March 2008
    428 Posts
    I must be doing something wrong with this. I have an engine (no matter which engine) connected to a transaxial gearbox (no matter which gearbox), which is connected to two wheels. When the body of the vehicle is frozen in the air, the engine seems to work fine, but when its unfrozen and actually moving, its just stuck at idle speeds, with minimal power (although it IS moving, at a VERY SLOW speed), unless I have the gear ratio at something like 0.07. I can't find ANY tutorials either, so I don't know what I'm doing wrong. :c