Modding - Revision history

Marcuz at 20:25, 21 August 2017

2017-08-21T20:25:07Z

Newjorciks: /* Lua */

2017-08-13T20:19:15Z

‎Lua

Marcuz at 20:05, 13 August 2017

2017-08-13T20:05:14Z

Marcuz at 20:04, 13 August 2017

2017-08-13T20:04:13Z

Marcuz at 20:02, 13 August 2017

2017-08-13T20:02:25Z

Marcuz at 20:00, 13 August 2017

2017-08-13T20:00:40Z

Marcuz at 19:58, 13 August 2017

2017-08-13T19:58:20Z

Marcuz at 19:53, 13 August 2017

2017-08-13T19:53:13Z

Marcuz at 19:51, 13 August 2017

2017-08-13T19:51:23Z

Marcuz: Created page with "Anyone is allowed to create modifications to prometheus code which they can share or even sell, as long as these requirements are met: The person sharing/selling the modificat..."

2017-08-13T18:01:34Z

Created page with "Anyone is allowed to create modifications to prometheus code which they can share or even sell, as long as these requirements are met: The person sharing/selling the modificat..."

New page

Anyone is allowed to create modifications to prometheus code which they can share or even sell, as long as these requirements are met:
The person sharing/selling the modification has purchases Prometheus.
Amount of files changed is the minimal possible(Only files that MUST be modified should be modified and shared, adding unnecessary stuff to a file only for it to be shareable is also violation of this requirement)
You must state on the modification page that it is a derivative work of Prometheus, and also link to Prometheus’ addon page
You must also state that adding the modification to Prometheus will mean that any errors or problems involving stuff the modification changes will NOT be helped with by the Prometheus support team.
Your modification must be freely accessible by the Prometheus support team(Can be done after requested by us)
The modification doesn’t contain Prometheus files from any of these files/folders:
/inc/functions.php (you can put any class files in inc/classes and run them from any file loaded elsewhere, they autoload)
- /cache/*
- /vendor/*
- /cert/*
- /inc/lib/*
- /mods/*
- install.php
- ipn.php
- paymentwall.php
- inc/classes/verification.class.php
- inc/classes/paymentwall.class.php
- inc/classes/stripe.class.php
- inc/classes/update.class.php
- inc/classes/cache.class.php
- inc/classes/mods.class.php
No modifications regarding license verification
You need to inform the user that is downloading your modification of the files modified BEFORE they are required to pay(So they can check if any other modifications they already have, have modified a file yours has as well)
The modification MUST include a modification info file located in “mods” folder, example of syntax can be found in examplemod.txt (Make the filename as unique as you can)

You are allowed to include new files/folders of your own to any folder as long as they do not replace any of Prometheus files/folders. This includes /vendor, but only through the use of composer.

Modding info for Lua side:

Usable hooks:
PrometheusAddActions
Arguments: none
Add any custom actions inside this hook using Prometheus.AddAction function(Described lower)

PrometheusDBConnected
Arguments: none
Ran when Prometheus has just connected to the database

PrometheusDBInitialized
Arguments: none
Ran when Prometheus has fully connected to the database and has run any initializing queries

PrometheusInitialized
Arguments: none
Ran when Prometheus has fully loaded(All it’s functions/values have been created)

PrometheusRunningAction
Arguments:
Table Table of players that this action will run on(Can contain SteamID strings or Player Objects)
String Name of the action
Table Table of values for that action
Table Table of action data(steam64 of person, active status, expire time, etc)
Ran when Prometheus is running an action(For any custom new actions, use PrometheusAddActions hook instead, this is for informational purposes)

Usable functions:
Prometheus.AddAction
Arguments:
Table Table that contains these values:
name => String Name of the action
runfunc => Function Function that will run when the action is bought(Arguments are: Player object, Table of values for that action, Table of action data)
endfunc => Function Functions that will run when the action has expired or deactivated(Arguments are: Player object, Table of values for that action, Table of action data)

Use this to create your own custom actions(Keep in mind you need to also mod web side to be able to save/buy that action).
Examples of actions can be found in actions.lua file.

@@ Line 1: / Line 1: @@
 === Web ===
 Anyone is allowed to create modifications to prometheus code which they can share or even sell, as long as these requirements are met:
-* The person sharing/selling the modification has purchases Prometheus.
+* The person sharing/selling the modification must have purchased Prometheus.
 * Amount of files changed is the minimal possible(Only files that MUST be modified should be modified and shared, adding unnecessary stuff to a file only for it to be shareable is also violation of this requirement)
 * You must state on the modification page that it is a derivative work of Prometheus, and also link to Prometheus’ addon page

@@ Line 28: / Line 28: @@
 You are allowed to include new files/folders of your own to any folder as long as they do not replace any of Prometheus files/folders. This includes /vendor, but only through the use of composer.
 === Lua ===
-Usable hooks:
+==== Usable hooks: ====
-PrometheusAddActions
+==== Usable functions: ====
-Arguments: none
+'''Preferably don't modify Prometheus Lua files.'''
-Add any custom actions inside this hook using Prometheus.AddAction function(Described lower)
+Rather create your own separate add-on that uses the hooks/function overwrites to modify Prometheus Lua side, while not modifying files is almost impossible in PHP, in Lua it's pretty easy.
-PrometheusDBConnected
+Pretty much anything you would need to do can be acquired by using the hooks, if that isn't enough, you can use function overwrites, example of tapping into a function called "testFunc":
-Arguments: none
+local oldFunc = testFunc
-Ran when Prometheus has just connected to the database
+testFunc = function(...)
-PrometheusDBInitialized
+args = {...}
-Arguments: none
+-- Do anything here with the arguments, original function will still run by running the oldFunc(...)
-Ran when Prometheus has fully connected to the database and has run any initializing queries
+oldFunc(...)
-PrometheusInitialized
+end
 {| class="wikitable" !File / Folder
 |- | / inc functions.php |- cache * vendor cert lib mods |install.php |ipn.php |paymentwall.php |inc classes verification.class.php paymentwall.class.php stripe.class.php update.class.php cache.class.php mods.class.php |}
 |}

@@ Line 6: / Line 6: @@
 * You must also state that adding the modification to Prometheus will mean that any errors or problems involving stuff the modification changes will NOT be helped with by the Prometheus support team.
 * Your modification must be freely accessible by the Prometheus support team(Can be done after requested by us)
-The modification doesn’t contain Prometheus files from any of these files/folders:
+* '''The modification can't contain Prometheus files from any of these files/folders:''' (you can put any class files in inc/classes and run them from any file loaded elsewhere, they autoload)
 ** /inc/functions.php
 ** /cache/*

@@ Line 6: / Line 6: @@
 * You must also state that adding the modification to Prometheus will mean that any errors or problems involving stuff the modification changes will NOT be helped with by the Prometheus support team.
 * Your modification must be freely accessible by the Prometheus support team(Can be done after requested by us)
-* The modification doesn’t contain Prometheus files from any of these files/folders:   (you can put any class files in inc/classes and run them from any file loaded elsewhere, they autoload)
+The modification doesn’t contain Prometheus files from any of these files/folders:
-{| class="wikitable" !File/Folder
+* (you can put any class files in inc/classes and run them from any file loaded elsewhere, they autoload)
-|- |/inc/functions.php |- |/cache/* |- |/vendor/* |- |/cert/* |- |/inc/lib/* |- |/mods/*  |- |install.php |- |ipn.php |- |paymentwall.php |- |inc/classes/verification.class.php |- |inc/classes/paymentwall.class.php |- |inc/classes/stripe.class.php |- |inc/classes/update.class.php  |- |inc/classes/cache.class.php |- |inc/classes/mods.class.php |}
+** /inc/functions.php
 * No modifications regarding license verification
 * You need to inform the user that is downloading your modification of the files modified BEFORE they are required to pay(So they can check if any other modifications they already have, have modified a file yours has as well)
 * The modification MUST include a modification info file located in “mods” folder, example of syntax can be found in examplemod.txt (Make the filename as unique as you can)
 You are allowed to include new files/folders of your own to any folder as long as they do not replace any of Prometheus files/folders. This includes /vendor, but only through the use of composer.
 === Lua ===
 Usable hooks:
@@ Line 72: / Line 86: @@
 Examples of actions can be found in actions.lua file.

@@ Line 7: / Line 7: @@
 * Your modification must be freely accessible by the Prometheus support team(Can be done after requested by us)
 * The modification doesn’t contain Prometheus files from any of these files/folders:   (you can put any class files in inc/classes and run them from any file loaded elsewhere, they autoload)
-{| !File/Folder |- |/inc/functions.php |- |/cache/* |- |/vendor/* |- |/cert/* |- |/inc/lib/* |- |/mods/*  |- |install.php |- |ipn.php |- |paymentwall.php |- |inc/classes/verification.class.php |- |inc/classes/paymentwall.class.php |- |inc/classes/stripe.class.php |- |inc/classes/update.class.php  |- |inc/classes/cache.class.php |- |inc/classes/mods.class.php |}
+{| class="wikitable" !File/Folder
 * No modifications regarding license verification
 * You need to inform the user that is downloading your modification of the files modified BEFORE they are required to pay(So they can check if any other modifications they already have, have modified a file yours has as well)