Post Date: November 04 2019 - 16:57:27.


Prop Chooser Documentation

An Enhanced addons for Prop Hunt: Enhanced which gives you ability for changing other objects/props within the Map's props or even Custom Props (with a list)

How does it Works?

This addon only supported for Prop Hunt: Enhanced. Here's how it works:

Once the map has been loaded, map props will be scanned and added into a list, in serverside. Once player joined, the list will be available. Props can either use this feature by Pressing F8 key to bring up the menu. Props can have usage limit to change their prop as they want. By default, it has 3 time chance usage. If usage drains out, you cannot use it anymore. (or can be unlimited!) If you have enough room to disguise other object (it has spatial detection, which this will prevent you stuck on the wall), select which props that you'd like to change and... Taadaaa...! hunters will confuse to find you!

Also to note that This addon is a Server-sided Feature. It's not mean to be available for client side!

How to Contribute or Support?

Feel free to open a pull request with this repository, if you have any better suggestions!

I worked this nearly about 6 hours, pretty quickly because just wanted to make one. Hey if you have a time, Feel free to contribute by supporting! Support on Ko-fi: https://ko-fi.com/wolvyrra/ Support on Official Website: https://www.wolvindra.net/donate/

How's about Customisation and/or configurations?

I'll write a little documentation here how to configure this thing, without modifying it's code!

Console Variable & Configurations

  • pcr_enable : Enable/Disable this Feature.
  • pcr_allow_custom : Allow custom prop models to be added outside from the map's props.
  • pcr_enable_prop_ban : Enable Prop Banning. This will also includes the ban list from PH:E Prop Bans list too.
  • pcr_max_enable : Enable/Disable Limit the maximum of addition to the Prop Chooser.
  • pcr_max_prop_list : Maximum number of Limit to be added to the Prop Chooser. Default is 100.
  • pcr_max_use : Maximum Usage after Props chosen their Prop. Default is 3.
  • pcr_default_key_menu : Default Key to open up a menu. Default is KEY_F8 (Value: 9). To change/bind to other keys, please see here: https://wiki.garrysmod.com/page/Enums/BUTTON_CODE

Experimental Section

  • pcr_enable_bbox_limit : Enable/Disable Prop's Bounding Box (AABB)/Hull Size Limit. Purpose is to prevent using any larger objects which might be unexpected.
  • pcr_bbox_max_height : Entity Max Height of Bounding Box (AABB)/Hull Size. Default is 96, 72 (Standard Kleiner model).
  • pcr_bbox_max_width : Entity Max Width of Bounding Box (AABB)/Hull Size. Default is 72, 56, or 48.

How to Add Custom Props & Adding Prop Bans?

Simply, navigate to your Root Garry's Mod game data folder, e.g: "../garrysmod/data/phe_config/"

You'll see two folder called:

  • A folder "prop_chooser_custom" containing "models.txt", which will be used to add new Props Model; and
  • A folder "prop_model_bans" containing "model_bans.txt" and "pcr_bans.txt" which will be used to add Prop Bans model.
  • Make sure these files & folders are Writeable!

Each data will contains something like this:

[
    "models/something.mdl",
    "models/anothermodels.mdl",
    -- And here you can add more models with specified path/models you want.
]

But, How do I get model listed after it being added?

Currently there is a console command to debug which models has been added to the Prop Chooser List. By using a command: "pcr_debug_model_list" This command will prints All available models listed which specified from the maps, and can be accessed only by Admin/Superadmin.

I got Errors!

Please open up an issue on Issue tracker if you have anything with Error and other issues related. Please NOTE that:

  • This addon is in BETA stage. Buggy may still persists!
  • This Addon currently only works with Prop Hunt: Enhanced gamemode. There are currently support for Classic version yet!.
  • If you don't subscribed PH:E, the addon will throw the Error.

LICENSE

Copyright (c) 2019 - Wolvindra-Vinzuerio https://project.wolvindra.net

All Rights Reserved.

This addon is intended use for Public Garry's Mod Server Hosting purpose only. Use for Personal purposes is allowed, unless you are permitted to use only for "PERSONAL" purposes.

By using this addon, you are agree that TO NOT use this addon:

  • to Re-share this addon without author permission
  • to Re-upload this addon to Workshop or garrysmod.org or any external websites without author permission
  • to Modify the code without author permission, (even though it's containing bug)
  • to Re-Selling the code
  • to Distributing or Redistributing the code without author permission to do so.
  • to Use for Commercial purpose. This include Personal Commercial Purpose (Advertised, Promotted, etc) To learn aboout this, please contact at [email protected]

Back to Main Page