🟥3.7.0.0

A list of changes for this release are provided below.

This release requires rlib to be updated to v4.0.0.0

The new version completely re-writes a lot of how the system worked, as well as removes a crap ton of no longer needed things and puts the library into a "minified" version. It also includes some optimizations that will definitely show a benefit when loading resource heavy scripts such as XTask and Arivia v3.

▸ Overview

• [ + ] added ability to support various keyboard layouts

• [ + ] new keyboard layout AZERTY

• [ + ] new keyboard layout QWERTZ

• [ + ] added right-click menu to copy binds to clipboard

• [ + ] ability to now group multiple keys into a family and simulate one solid key

• [ + ] added detection for the following commands:

  - gm_showhelp

  - gm_showteam - gm_showspare1 - gm_showspare2 - messagemode - messagemode2 - ulx menu - ulx motd - ulx noclip - ulx god - toggleconsole - jpeg - slot0 - slot1 - slot2 - slot3 - slot4 - slot5 - slot6 - slot7 - slot8 - slot9

• [ ^ ] increased key button sizes

• [ ^ ] new rules interface

• [ ^ ] header / ticker have screen scaling, including exit button

• [ ^ ] key functions execute and and condition renamed - execute now called onClick - condition now called enabled

• [ ^ ] updated web and rules interface

• [ ^ ] removed sh_cfg.rules.txt config file, merged with sh_cfg.nav

• [ % ] fixed bug which would incorrectly identify commands with spaces

• [ % ] fixed unregistered hook pirithous_fonts_register

▸ Detailed Changes

▸ Added Ability to Support Various Layouts

There is now a specialized button located at the bottom right of the keyboard which allows a player to change keyboard layouts.

▸ New Keyboard Layout AZERTY

AZERTY is a specific layout for the characters of the Latin alphabet on computer keyboards. The layout takes its name from the first six letters to appear on the first row of alphabetical keys; that is, (A Z E R T Y). Similar to the QWERTZ layout, it is modeled on the English QWERTY layout. It is used in France and Belgium.

▸ New Keyboard Layout QWERTZ

The QWERTZ or QWERTZU keyboard is a keyboard layout widely used in Central Europe. The name comes from the first six letters at the top left of the keyboard: (Q W E R T Z).

▸ Added Right-Click Menu to Copy Binds

Each button has gained a right-click function which makes a menu open. The menu contains certain actions for binding keys to particular actions.

Unfortunately, Garry's Mod / Facepunch has blocked the ability to force players to execute certain console commands such as the bind command.

Instead, this menu will copy the proper command you need to your clipboard and then will automatically open your player console so that you can paste the command.

Right click on the key you wish to assign, and then select which feature you want to bind. Once the command is copied to your clipboard, simply CTRL + V (paste) in your console and press ENTER.

Only special actions are on this menu since the other actions such as running, jumping, etc; can be re-bound by simply opening your Garry's Mod Keybind Menu. You can access this by clicking the cog icon in the top left corner.

▸ Added Key Family Grouping

Grouping keys allows multiple keys to be activated at the same time. On the new QWERTZ and AZERTY layouts; the ENTER key is theoretically two keys. With the family grouping feature, this can give the keys the appearance of being one complete key instead of two. This allows for hovering both keys at the same time.

cfg.azerty.keys.row.three =
{
    { enabled = true, width = 62, lbl = '..' },
    { enabled = true, width = 62, lbl = '£', sub = '$', alt = '¤' },
    { enabled = true, width = 14, fam = 'key_enter', lbl = '' },
    { enabled = true, width = 60, fam = 'key_enter', lbl = 'ENTER' },ua
}

▸ Added Auto Detection of Gmod Binds

Keys bound to particular actions in Garry's Mod will automatically display on the keyboard.

The following actions have been added for auto-detection:

Bind	Description
gm_showhelp	F1 key Functionality changes depending on the gamemode.
gm_showteam	F2 key Functionality changes depending on the gamemode. Usually used for selecting your team.
gm_showspare1	F3 key Functionality changes depending on the gamemode. For DarkRP, this makes your cursor appear.
gm_showspare2	F4 key Functionality changes depending on the gamemode. For DarkRP, this is the F4 menu to buy entities or change jobs.
+forward	Step forward
+back	Step backward
+moveleft	Strafe Left
+moveright	Strafe Right
+jump	Jump
+duck	Duck / crouch
+speed	Shift key Sprint
+walk	Walk instead of run
+use	E key Open doors, pick up items.
+menu_context	C key Open context menu. Change draw settings, change / view player models. Some addons will add menus here such as Third Person.
+reload	R key Reload weapon
+menu	Q key Open Spawn menu. Allows you to spawn props, entities, NPCs, etc.
+showscores	TAB key Scoreboard
+undo	Z key Undo last action
messagemode	Y key Global chat
messagemode2	U key Team chat
+voicerecord	Voice chat
ulx menu	Opens ULX Admin Menu Requires ULX on server Only works if bound to key with console command bind "ulx menu" KEYHERE
ulx motd	Opens ULX Message of the Day Requires ULX on server Only works if bound to key with console command bind "ulx motd" KEYHERE
ulx noclip	Activates ULX noclip Requires ULX on server Only works if bound to key with console command bind "ulx noclip" KEYHERE
ulx god	Activates ULX god mode Requires ULX on server Only works if bound to key with console command bind "ulx god" KEYHERE
toggleconsole	Opens developer console
jpeg	Take screenshot
slot0	Inventory slot 0
slot1	Inventory slot 1
slot2	Inventory slot 2
slot3	Inventory slot 3
slot4	Inventory slot 4
slot5	Inventory slot 5
slot6	Inventory slot 6
slot7	Inventory slot 7
slot8	Inventory slot 8
slot9	Inventory slot 9

▸ New Rules Interface

The rules interface has been updated with a new scrollbar with a little bounce. A small but nice change.

Rules: Old Interface

Rules: New Interface

▸ Resized Key Button Sizes

Increased the size of keyboard keys

▸ Header / Footer / Icons Have Screen-scaling

Header, footer, and icons now have screen scaling

▸ Key Function Name Changes

Due to confusion, a few function names in configuration file have been changed.

OLD

{
    key         = 'F12',
    desc        = 'act_steam_screenshot',
    clr         = Color( 54, 145, 72 ),
    condition   = function( )
                    return true
                end,
    execute     = function( )
                    rcc.run.gmod( 'screenshot' )
                end
},

NEW

{
    key         = 'F12',
    desc        = 'act_steam_screenshot',
    clr         = Color( 54, 145, 72 ),
    enabled   = function( )
                    return true
                end,
    onClick     = function( )
                    rcc.run.gmod( 'screenshot' )
                end
},

If adding new keys to the cfg.qwerty.keys.binds, you MUST make sure the function enabled returns true if you want the key to show.

▸ Updated Web and Rules Interface

Updated the web and rules interfaces. Now has screen-scaling and an updated interface appearance.

▸ Removed sh_cfg_rules, Moved to sh_cfg.nav

Having both a nav file and a rules config file were too confusing.

cfg/sh_cfg_rules.lua has been removed, and the configs have been moved to:

cfg/sh_cfg_03_nav.lua

The integrated web setting has also been moved to the area with the other rule settings:

cfg.nav.btn.rules_url	            = 'https://pirithous.rlib.io/internal/rules'
cfg.nav.btn.rules_openIngame        = false
cfg.nav.btn.rules_textonly          = true

rules_url	The URL players will be taken to when clicking the rules button. In order to use websites, the setting rules_textonly must be false.
rules_openIngame	true: built-in web browser will be used to display websites. false: steam overlay browser will be used
rules_textonly	true: instead of a website, rules will be displayed as text. false: player will be taken to a website to show rules instead of text. if true, you can edit the rules in the game file under the setting cfg.rules.text

▸ Fixed bug that incorrectly assigns actions to keys

Some customers reported issues with certain keys not properly assigning actions. This issue has been fixed.

▸ Fixed unregistered hook pirithous_fonts_register

When opening the main interface, the fonts were not reloading and causing confusion with customers attempting to modify the font sizes.

Fonts now automatically reload when the player opens the interface after closing it.