Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 0 additions & 48 deletions .github/workflows/build-v2.yml

This file was deleted.

43 changes: 43 additions & 0 deletions .github/workflows/v2.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
name: 🔨 Build ThreatenGL
on: [pull_request, push, workflow_dispatch]

jobs:
build:
strategy:
matrix:
java: [21]

runs-on: ubuntu-22.04

steps:
- name: Checkout repository
uses: actions/checkout@v4

- name: Validate gradle wrapper
uses: gradle/actions/wrapper-validation@v4

- name: Setup JDK ${{ matrix.java }}
uses: actions/setup-java@v4
with:
java-version: ${{ matrix.java }}
distribution: "temurin"

- name: Make gradle wrapper executable
run: chmod +x ./gradlew

- name: Build ThreatenGL
run: ./gradlew build

- name: Bundle mod loader jars for upload
run: |
mkdir gh-artefacts-upload
mv fabric/build/libs/*.jar gh-artefacts-upload/
mv forge/build/libs/*.jar gh-artefacts-upload/
mv neoforge/build/libs/*.jar gh-artefacts-upload/
mv quilt/build/libs/*.jar gh-artefacts-upload/

- name: Upload artefacts
uses: actions/upload-artifact@v4
with:
name: Built Artefacts
path: gh-artefacts-upload/
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
# macOS files
*._**
*.DS_**

# gradle

.gradle/
Expand Down
18 changes: 11 additions & 7 deletions README-modrinth.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,31 @@
This description has been simplified to make it friendlier and easier to understand on modrinth. For the full description, please visit the [GitHub repository](https://github.com/Numelon-Softworks/ThreatenGL).

[![CodeFactor](https://www.codefactor.io/repository/github/numelon-softworks/threatengl/badge)](https://www.codefactor.io/repository/github/numelon-softworks/threatengl)
[![CodeFactor](https://www.codefactor.io/repository/github/richy-z/threatengl/badge)](https://www.codefactor.io/repository/github/richy-z/threatengl)
[![Modrinth Downloads](https://img.shields.io/badge/dynamic/json?labelColor=black&color=grey&label=&suffix=%20downloads&query=downloads&url=https://api.modrinth.com/v2/project/threatengl&style=flat&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAMAAABEpIrGAAAAIGNIUk0AAHomAACAhAAA+gAAAIDoAAB1MAAA6mAAADqYAAAXcJy6UTwAAAJPUExURQAAABvZahWnUha1WAYzGQlHIxvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZahvZav///9ScwmYAAADDdFJOUwAAAAAAAA8zW3uOYwIBK3rB6Pn+ml18KiGL5HEDquOIH07R/UzKz2zu+uLHIibtafWkVCMNBRqg7/RQuT8EQbvT+5ETDBSU/NAgCSdZlcQKii7mtxJY5fF/7D1SRkB+EcWh4UilOOtPMdTCR1PqN969vmGDCw7G4DSSsAcGHrSPr3bds5CEwDKoXumcZdwcG4KmjayX32A79pjOqRjIFoXynVYVgPi6qxDnL78p2obVJFquNbGZCPdyvHPZ1yhuh8s+iRzcsrEAAAABYktHRMQUDBvhAAAAB3RJTUUH5wQXDwgZWDUtiQAAAqRJREFUOMttU/k7lFEU/k4L4hsxtNAnhRgiJZOiSfbI2oJpmRFCi2kV0aaNVLTIEpVISmnf97r/WO+534yZnqfzw73vOe+559xz7rmKIoVYvLx95vj6qUSqVBW3sGrwnxsQaAwSwcDz5i9g0wxPfmFIqJCyiEgLE4vDl7iD8PGlETotIqOQahlAdJTLA5sWY5JsbNzysHiihEBWViRqRDOlgyFmJVtMq5JWJ5vhvyZlLevrEmUILKl8PihtvYWcYt6QLmNwFjjEb4SSkZnlZLO5yJzcPBg35bODwZfPZxYwWbC5sKjYzwBUkssxSg1wKNsCtHUb89vTy3GwopBxDmcJ9YdDJYB1B9t2WmUtcbtkqt18Mxsp9irsezS2VEu+uka/mqUWSrFd2VsnhLEetoZ9TFv3HwCexdUdjBWi0aH4YTuEvtoPM3/EO1nnuTpEjD2qHIM54DhR0wmA5hZySzIntyknsbZyi8IB0tp07tRpBDKfgeWsdDjHDlFGRIjnl3O0t573gcMFUBeVS1gvlxB1dOZxv0pIu9IF01UDZRdjr1SuZQhxvbvnRrmsMePmrdsrGPRaKP8OLtmn9KM7A4N3xb8yNExUb5RlZt2btpZbXajzPoYkBaDKrtADp3HkYdloo56ndgx37UcHxSP0tIWBGH9cg1nx6TJFTNhS7eCfcA1PJ+GgDbLDs2GuX3V05Ohj0xYSBGumyq/yfApw4EWTRxPJqxQvIF6+ks9Gr0d4nN+8Nbhoi+NdJEwVSc6hVNvHOUvg+5qeDxoP3GQz6x8/qXLuZ6Op7SPy+gNTnydSELabk1Z8Mbs/hlr4dbobfUgxJMS3UdXza9H33jqnA3/OH41FCZ7/l7HW8vOXiWc9GvPf06D953/T2O/EP8HBNtcH0Zm/lqFNUgTAex4AAAAldEVYdGRhdGU6Y3JlYXRlADIwMjMtMDQtMjNUMTU6MDg6MjQrMDA6MDAE5dOaAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDIzLTA0LTIzVDE1OjA4OjI0KzAwOjAwdbhrJgAAACh0RVh0ZGF0ZTp0aW1lc3RhbXAAMjAyMy0wNC0yM1QxNTowODoyNSswMDowMITaQU0AAAAASUVORK5CYII=
)](https://modrinth.com/mod/threatengl)

# 🤬 ThreatenGL

Welcome to ThreatenGL!

ThreatenGL is a Minecraft mod that takes a stand against the outdated OpenGL version 3.2, ***threatening*** Minecraft to use the more modern version 4.6. This mod aims to explore the effects of this change.


> Minecraft: "please... anything but that!" 😰
>
> ThreatenGL: "opengl version 4.6, or else!" 😡🔪

[![ThreatenGL Banner](https://raw.githubusercontent.com/Numelon-Softworks/ThreatenGL/main/0-OtherFiles/Logo/Banner.png)](https://modrinth.com/mod/threatengl)
[![ThreatenGL Banner](https://raw.githubusercontent.com/Richy-Z/ThreatenGL/main/0-OtherFiles/Logo/Banner.png)](https://modrinth.com/mod/threatengl)

## 🤨 What's the deal?

ThreatenGL is about testing the effects of changing the OpenGL version, and potentially enhancing your experience. By ***threatening*** Minecraft to switch to OpenGL 4.6, this mod aims to investigate how OpenGL version changes affect the functioning of your GPU. Users have reported smoother gameplay and better frame rates, especially on newer devices.

For a more detailed description of what this does, please visit the [GitHub repository](https://github.com/Numelon-Softworks/ThreatenGL). (Mod developers, please read this to understand the mod in-depth!)
For a more detailed description of what this does, please visit the [GitHub repository](https://github.com/Richy-Z/ThreatenGL). (Mod developers, please read this to understand the mod in-depth!)

## ⚙️ How does it work?

ThreatenGL works its magic by tinkering with Minecraft's internals. By injecting some code into the game's graphics setup process, it convinces Minecraft to opt for OpenGL 4.6 instead of the old 3.2. This simple tweak has the *potential* to make a difference in how the game performs, as some GPU manufacturers like to use different, specific profiles for different OpenGL versions in their drivers. (I have no idea why they do that, but I'm guessing its for compatibility)

## 📥 Installing the Mod

Installing this mod is as simple as putting it inside the `mods` directory of Minecraft.

**Since 1.3.2-beta.1, ThreatenGL no longer requires any more additional libraries!**
Expand All @@ -42,19 +43,22 @@ Fabric and NeoForge have always worked without any additional dependencies.
</details>

## 🔒 Will this mod work for me?

This mod will **NOT** do anything if your hardware does not support OpenGL 4.6.

**On macOS**, this mod will force OpenGL 4.1 instead of 4.6 as Apple deprecated OpenGL in favour of Metal starting with macOS Mojave (10.14) and has not updated it since.

The OpenGL 4.6 specification was released on July 31st, 2017. **Generally, this mod should work if:**

- you have an Nvidia Graphics Card from 2012 and upwards (Nvidia Kepler and above are supported)
- you have an AMD Graphics Card from 2012 and upwards (AMD GCN and above are supported)
- you have any Graphics Card which currently actively receives driver updates
- you have any Graphics Card which used to receive driver updates up until or after the release date of the OpenGL 4.6 specification

## ❗Notes

ThreatenGL has been thoroughly tested to ensure it doesn't explore your device. However, please keep in mind that this is still an experiment and the efficacy of this mod is being actively researched and discussed. While many users have seen positive results, **your** results may vary depending on your setup.

If you encounter any issues, feel free to reach out by [posting an issue on GitHub](https://github.com/Numelon-Softworks/ThreatenGL/issues) or [joining the Discord Server](https://discord.gg/eYEDsnKh2T), and I'll do my best to assist you in any way I can! :)
If you encounter any issues, feel free to reach out by [posting an issue on GitHub](https://github.com/Richy-Z/ThreatenGL/issues) or [joining the Discord Server](https://discord.gg/eYEDsnKh2T), and I'll do my best to assist you in any way I can! :)

**Have a great day/night, and enjoy this mod! 😊**
Loading