1.2.0 Release Final

Author: Fanorisky

.github/workflows/build.yml

@@ -29,7 +29,7 @@ jobs:
 
       - name: Build Docker image
         run: |
-          docker build -t omp-easing-functions/build:ubuntu-18.04 docker/build_ubuntu-18.04/
+          docker build -t Randomix/build:ubuntu-18.04 docker/build_ubuntu-18.04/
 
       - name: Run build in Docker container
         env:
@@ -42,7 +42,7 @@ jobs:
             -v "${{ github.workspace }}/docker/build:/code/build" \
             -e CONFIG=${CONFIG} \
             -e BUILD_SERVER=${BUILD_SERVER} \
-            omp-easing-functions/build:ubuntu-18.04
+            Randomix/build:ubuntu-18.04
 
       - name: Upload Linux .so artifacts
         uses: actions/upload-artifact@v4

CMakeLists.txt

@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.19)
-project(omp-easing-functions LANGUAGES C CXX VERSION 0.0.1)
+project(PawnRandomix LANGUAGES C CXX VERSION 0.0.1)
 
 set(CMAKE_CXX_STANDARD 17)
 

README.md

@@ -1,126 +1,74 @@
-# open.mp Easing-Functions Component
+# Pawn Randomix
 
-An open.mp server component that adds textdraw easing and animation functionality.
-It is essentially a component-based version of the original
-[pawn-easing-functions](https://github.com/alexchwoj/pawn-easing-functions.git) by [alexchwoj](https://github.com/alexchwoj), with improvements and optimized performance for large-scale animations.
-
----
+Enhanced random number generator and utility for open.mp servers (SA-MP support planned), providing a PRNG (PCG32) for game mechanics and a CSPRNG (ChaCha20) for cryptographic security.
 
 ## Installation
 
-1. Go to the **Releases** page and download the archive or binary matching your server platform (Windows `.dll`, Linux `.so`).
-2. Extract it and place the component file into your open.mp server `components/` directory.
-3. Copy `omp_easing.inc` into the include directory used by your Pawn compiler (e.g. `gamemodes/qawno/include/`).
-4. Add
-
-   ```pawn
-   #include <omp_easing>
-   ```
-
-   to any script where you want to use easing native functions, then recompile your scripts.
-
----
+1. Download component binary for your platform (Windows `.dll`, Linux `.so`)
+2. Place in server `components/` directory
+3. Copy `Randomix.inc` to Pawn include directory
+4. Add `#include <Randomix>` to your scripts
+5. Recompile
 
 ## Functions
 
+### PRNG (Fast Game Mechanics)
 ```pawn
-// Utility
-native Float:GetEasingValue(Float:t, easeType);
-native Float:Lerp(Float:start, Float:end, Float:t);
-native LerpColor(color1, color2, Float:t);
-
-// Position
-native PlayerText_MoveTo(playerid, PlayerText:textdraw, Float:x, Float:y, duration, easeType, bool:silent = false);
-native PlayerText_MoveToX(playerid, PlayerText:textdraw, Float:x, duration, easeType, bool:silent = false);
-native PlayerText_MoveToY(playerid, PlayerText:textdraw, Float:y, duration, easeType, bool:silent = false);
-
-// Size
-native PlayerText_MoveLetterSize(playerid, PlayerText:textdraw, Float:y, duration, easeType, bool:silent = false);
-native PlayerText_MoveTextSize(playerid, PlayerText:textdraw, Float:x, duration, easeType, bool:silent = false);
-native PlayerText_MoveSize(playerid, PlayerText:textdraw, Float:x, Float:y, duration, easeType, bool:silent = false);
-
-// Color
-native PlayerText_InterpolateColor(playerid, PlayerText:textdraw, color, duration, easeType, bool:silent = false);
-native PlayerText_InterpolateBoxColor(playerid, PlayerText:textdraw, color, duration, easeType, bool:silent = false);
-native PlayerText_InterpolateBGColor(playerid, PlayerText:textdraw, color, duration, easeType, bool:silent = false);
-
-// General
-native PlayerText_PlaceOnTop(playerid, PlayerText:textdraw);
-native PlayerText_StopAnimation(animator_id);
-native IsAnimationActive(animator_id);
-
-// Debug and monitoring
-native GetActiveAnimationsCount();
-native GetAnimationStats(&totalCreated, &peakConcurrent, &totalCallbacks);
+PRandom(max)                     // 0 to max-1
+PRandRange(min, max)             // Range integer
+PRandFloatRange(Float:min, Float:max)  // Range float
+PRandBool(Float:probability)     // Probability boolean
+PRandWeighted(weights[], count)  // Weighted selection
+PRandShuffle(array[], count)     // Fisher-Yates shuffle
+PRandGaussian(Float:mean, Float:stddev) // Normal distribution
+PRandDice(sides, count)          // Dice roll (2d6, 1d20, etc.)
+SeedPRNG(seed)                   // Set PRNG seed
 ```
 
----
-
-## Callback
-
+### CSPRNG (Cryptographic Security)
 ```pawn
-OnAnimatorFinish(playerid, animatorid, textdrawid, types);
+CSPRandom(max)                   // Secure 0 to max-1
+CSPRandRange(min, max)           // Secure range
+CSPRandFloatRange(Float:min, Float:max) // Secure float
+CSPRandBool(Float:probability)   // Secure boolean
+CSPRandToken(length)             // Hex token (1-8 digits)
+CSPRandBytes(dest[], length)     // Cryptographic bytes
+CSPRandUUID(uuid[])              // UUID v4 string
+SeedCSPRNG(seed)                 // Set CSPRNG seed (testing only)
 ```
 
----
-
-## Easing Types
+## Usage
 
-```
-EASE_IN_SINE
-EASE_OUT_SINE
-EASE_IN_OUT_SINE
-EASE_IN_QUAD
-EASE_OUT_QUAD
-EASE_IN_OUT_QUAD
-EASE_IN_CUBIC
-EASE_OUT_CUBIC
-EASE_IN_OUT_CUBIC
-EASE_IN_QUART
-EASE_OUT_QUART
-EASE_IN_OUT_QUART
-EASE_IN_QUINT
-EASE_OUT_QUINT
-EASE_IN_OUT_QUINT
-EASE_IN_EXPO
-EASE_OUT_EXPO
-EASE_IN_OUT_EXPO
-EASE_IN_CIRC
-EASE_OUT_CIRC
-EASE_IN_OUT_CIRC
-EASE_IN_BACK
-EASE_OUT_BACK
-EASE_IN_OUT_BACK
-EASE_IN_ELASTIC
-EASE_OUT_ELASTIC
-EASE_IN_OUT_ELASTIC
-EASE_IN_BOUNCE
-EASE_OUT_BOUNCE
-EASE_IN_OUT_BOUNCE
-EASE_NONE
+```pawn
+#include <pawn-randomix>
+
+// Game mechanics (fast PRNG)
+new damage = PRandom(100);
+new position = PRandRange(10, 50);
+new lootIndex = PRandWeighted(lootWeights, 4);
+ShuffleArray(players);
+
+// Security operations (CSPRNG)
+new token = CSPRandToken(8);
+new uuid[37];
+CSPRandUUID(uuid);
 ```
 
----
+## Helper Macros
 
-## Animation Enum
-```
-enum eAnimatorTypes 
-{
-	ANIMATOR_POSITION,
-	ANIMATOR_LETTER_SIZE,
-	ANIMATOR_TEXT_SIZE,
-	ANIMATOR_FULL_SIZE,
-	ANIMATOR_COLOR,
-	ANIMATOR_BOX_COLOR,
-	ANIMATOR_BACKGROUND_COLOR
-}
+```pawn
+RandomChance(25)         // 25% chance
+CoinFlip()              // 50/50 chance
+RollD20()               // 1d20 dice roll
+RandomElement(array, size) // Random array element
+SecureRandomElement(array, size) // Secure random element
+ShuffleArray(array)     // Shuffle entire array
 ```
 
-You can preview each easing type visually here: [https://easings.net/](https://easings.net/)
-
----
-
 ## Credits
-- [alexchwoj](https://github.com/alexchwoj) and all pawn-easing-functions contributors
-- [AmyrAhmady](https://github.com/AmyrAhmady) for the open.mp component SDK
-- [Fanorisky](https://github.com/Fanorisky) (me)
+- PCG Random by Melissa O'Neill
+- ChaCha20 by Daniel J. Bernstein
+- open.mp Component SDK by AmyrAhmady
+- Fanorisky (me)
+
+GitHub: https://github.com/Fanorisky/pawn-randomix