Skip to content

Commit 58feedc

Browse files
AlphalaneousAlphalaneous
committed
Initial commit
0 parents  commit 58feedc

15 files changed

+591
-0
lines changed

‎.gitattributes

+2
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# Auto detect text files and perform LF normalization
2+
* text=auto

‎.github/workflows/multi-platform.yml

+55
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
name: Build Geode Mod
2+
3+
on:
4+
workflow_dispatch:
5+
push:
6+
branches:
7+
- "**"
8+
9+
jobs:
10+
build:
11+
strategy:
12+
fail-fast: false
13+
matrix:
14+
config:
15+
- name: Windows
16+
os: windows-latest
17+
18+
- name: macOS
19+
os: macos-latest
20+
21+
- name: Android32
22+
os: ubuntu-latest
23+
target: Android32
24+
25+
- name: Android64
26+
os: ubuntu-latest
27+
target: Android64
28+
29+
name: ${{ matrix.config.name }}
30+
runs-on: ${{ matrix.config.os }}
31+
32+
steps:
33+
- uses: actions/checkout@v4
34+
35+
- name: Build the mod
36+
uses: geode-sdk/build-geode-mod@main
37+
with:
38+
bindings: geode-sdk/bindings
39+
bindings-ref: main
40+
combine: true
41+
target: ${{ matrix.config.target }}
42+
43+
package:
44+
name: Package builds
45+
runs-on: ubuntu-latest
46+
needs: ['build']
47+
48+
steps:
49+
- uses: geode-sdk/build-geode-mod/combine@main
50+
id: build
51+
52+
- uses: actions/upload-artifact@v4
53+
with:
54+
name: Build Output
55+
path: ${{ steps.build.outputs.build-output }}

‎.gitignore

+64
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# Prerequisites
2+
*.d
3+
4+
# Compiled Object files
5+
*.slo
6+
*.lo
7+
*.o
8+
*.obj
9+
10+
# Precompiled Headers
11+
*.gch
12+
*.pch
13+
14+
# Compiled Dynamic libraries
15+
*.so
16+
*.dylib
17+
*.dll
18+
19+
# Fortran module files
20+
*.mod
21+
*.smod
22+
23+
# Compiled Static libraries
24+
*.lai
25+
*.la
26+
*.a
27+
*.lib
28+
29+
# Executables
30+
*.exe
31+
*.out
32+
*.app
33+
34+
# Macos be like
35+
**/.DS_Store
36+
37+
# Cache files for Sublime Text
38+
*.tmlanguage.cache
39+
*.tmPreferences.cache
40+
*.stTheme.cache
41+
42+
# Ignore build folders
43+
**/build
44+
# Ignore platform specific build folders
45+
build-*/
46+
47+
# Workspace files are user-specific
48+
*.sublime-workspace
49+
50+
# ILY vscode
51+
**/.vscode
52+
53+
# Local History for Visual Studio Code
54+
.history/
55+
56+
# clangd
57+
.cache/
58+
59+
# Visual Studio
60+
.vs/
61+
62+
# CLion
63+
.idea/
64+
/cmake-build-*/

‎CMakeLists.txt

+27
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
cmake_minimum_required(VERSION 3.21)
2+
set(CMAKE_CXX_STANDARD 20)
3+
set(CMAKE_CXX_STANDARD_REQUIRED ON)
4+
set(CMAKE_OSX_ARCHITECTURES "arm64;x86_64")
5+
set(CMAKE_CXX_VISIBILITY_PRESET hidden)
6+
7+
project(AlphasGeodeUtils VERSION 1.0.0)
8+
9+
file(GLOB_RECURSE SOURCES
10+
src/*.cpp
11+
)
12+
13+
add_library(${PROJECT_NAME} SHARED ${SOURCES})
14+
15+
if (PROJECT_IS_TOP_LEVEL)
16+
target_compile_definitions(${PROJECT_NAME} PRIVATE ALPHALANEOUS_UTILS_API_EXPORTING)
17+
endif()
18+
19+
if (NOT DEFINED ENV{GEODE_SDK})
20+
message(FATAL_ERROR "Unable to find Geode SDK! Please define GEODE_SDK environment variable to point to Geode")
21+
else()
22+
message(STATUS "Found Geode: $ENV{GEODE_SDK}")
23+
endif()
24+
25+
add_subdirectory($ENV{GEODE_SDK} ${CMAKE_CURRENT_BINARY_DIR}/geode)
26+
27+
setup_geode_mod(${PROJECT_NAME})

‎README.md

+72
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
# Alpha's Geode Utils
2+
3+
Miscellaneous Geode utils to make development easier:
4+
5+
## Modifying any node
6+
7+
Familiar modify syntax as Geode, supporting fields. `class $modifyNode(SomeNode)`
8+
You can name the modified node the same way as well `class $modifyNode(MySomeNode, SomeNode)`
9+
10+
To use this, you will create a `void modify()` method within that class and inside of there you can change the node to your hearts content. You can use the fields struct just like in Geode to add fields if needed.
11+
12+
To edit the priority (lets say another mod modifies the same node using this) you can add `static int modifyPrio()` to the class which should return an integer value that is the priority you wish to set.
13+
14+
**Full Example modifying BetterInfo's CustomCreatorLayer:**
15+
16+
```c++
17+
class $nodeModify(MyCustomCreatorLayer, CustomCreatorLayer) {
18+
19+
static int modifyPrio() {
20+
return 10;
21+
}
22+
23+
struct Fields {
24+
int m_number = 0;
25+
};
26+
27+
void modify() {
28+
29+
CCSprite* spr = CCSprite::createWithSpriteFrameName("GJ_playBtn_001.png");
30+
CCMenuItemSpriteExtra* btn = CCMenuItemSpriteExtra::create(spr, this, menu_selector(MyCustomCreatorLayer::onEpicButton));
31+
btn->setID("epic-button"_spr);
32+
33+
if (CCMenu* creatorButtonsMenu = typeinfo_cast<CCMenu*>(getChildByID("cvolton.betterinfo/creator-buttons-menu"))) {
34+
creatorButtonsMenu->addChild(btn);
35+
creatorButtonsMenu->updateLayout();
36+
}
37+
}
38+
39+
void onEpicButton(CCObject* obj) {
40+
log::info("m_number {}", m_fields->m_number);
41+
m_fields->m_number++;
42+
}
43+
};
44+
```
45+
46+
## General Utils
47+
48+
### AlphaUtils::Cocos namespace:
49+
50+
Getting sprites while ignoring Texture Loader fallback:
51+
`std::optional<cocos2d::CCSprite*> getSprite(const char* sprName)`
52+
`std::optional<cocos2d::CCSprite*> getSpriteByFrameName(const char* sprFrameName)`
53+
54+
Getting a layer from the scene even during transition:
55+
`std::optional<Layer> getLayer()`
56+
57+
Setting a node color by hex code:
58+
`bool setColorByHex(cocos2d::CCRGBAProtocol* node, std::string colorHex)`
59+
60+
Checking if a parent node contains a node anywhere in a tree:
61+
`bool hasNode(cocos2d::CCNode* child, cocos2d::CCNode* parent)`
62+
63+
Getting a child by class name dynamically:
64+
`std::optional<cocos2d::CCNode*> getChildByClassName(cocos2d::CCNode* node, std::string name, int index = 0)`
65+
66+
Getting a node's class name:
67+
`std::string getClassName(cocos2d::CCObject* obj, bool removeNamespace = false)`
68+
69+
### AlphaUtils::Misc namespace:
70+
71+
Getting a random number:
72+
`int getRandomNumber(int lower, int upper)`

‎about.md

+72
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
# Alpha's Geode Utils
2+
3+
Miscellaneous Geode utils to make development easier:
4+
5+
## Modifying any node
6+
7+
Familiar modify syntax as Geode, supporting fields. `class $modifyNode(SomeNode)`
8+
You can name the modified node the same way as well `class $modifyNode(MySomeNode, SomeNode)`
9+
10+
To use this, you will create a `void modify()` method within that class and inside of there you can change the node to your hearts content. You can use the fields struct just like in Geode to add fields if needed.
11+
12+
To edit the priority (lets say another mod modifies the same node using this) you can add `static int modifyPrio()` to the class which should return an integer value that is the priority you wish to set.
13+
14+
**Full Example modifying BetterInfo's CustomCreatorLayer:**
15+
16+
```c++
17+
class $nodeModify(MyCustomCreatorLayer, CustomCreatorLayer) {
18+
19+
static int modifyPrio() {
20+
return 10;
21+
}
22+
23+
struct Fields {
24+
int m_number = 0;
25+
};
26+
27+
void modify() {
28+
29+
CCSprite* spr = CCSprite::createWithSpriteFrameName("GJ_playBtn_001.png");
30+
CCMenuItemSpriteExtra* btn = CCMenuItemSpriteExtra::create(spr, this, menu_selector(MyCustomCreatorLayer::onEpicButton));
31+
btn->setID("epic-button"_spr);
32+
33+
if (CCMenu* creatorButtonsMenu = typeinfo_cast<CCMenu*>(getChildByID("cvolton.betterinfo/creator-buttons-menu"))) {
34+
creatorButtonsMenu->addChild(btn);
35+
creatorButtonsMenu->updateLayout();
36+
}
37+
}
38+
39+
void onEpicButton(CCObject* obj) {
40+
log::info("m_number {}", m_fields->m_number);
41+
m_fields->m_number++;
42+
}
43+
};
44+
```
45+
46+
## General Utils
47+
48+
### AlphaUtils::Cocos namespace:
49+
50+
Getting sprites while ignoring Texture Loader fallback:
51+
`std::optional<cocos2d::CCSprite*> getSprite(const char* sprName)`
52+
`std::optional<cocos2d::CCSprite*> getSpriteByFrameName(const char* sprFrameName)`
53+
54+
Getting a layer from the scene even during transition:
55+
`std::optional<Layer> getLayer()`
56+
57+
Setting a node color by hex code:
58+
`bool setColorByHex(cocos2d::CCRGBAProtocol* node, std::string colorHex)`
59+
60+
Checking if a parent node contains a node anywhere in a tree:
61+
`bool hasNode(cocos2d::CCNode* child, cocos2d::CCNode* parent)`
62+
63+
Getting a child by class name dynamically:
64+
`std::optional<cocos2d::CCNode*> getChildByClassName(cocos2d::CCNode* node, std::string name, int index = 0)`
65+
66+
Getting a node's class name:
67+
`std::string getClassName(cocos2d::CCObject* obj, bool removeNamespace = false)`
68+
69+
### AlphaUtils::Misc namespace:
70+
71+
Getting a random number:
72+
`int getRandomNumber(int lower, int upper)`

‎changelog.md

+2
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# 1.0.0
2+
- Initial Release

‎include/NodeModding.h

+61
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
#pragma once
2+
3+
#include <unordered_map>
4+
#include <string>
5+
#include <functional>
6+
#include <Geode/cocos/base_nodes/CCNode.h>
7+
8+
#ifdef GEODE_IS_WINDOWS
9+
#ifdef ALPHALANEOUS_UTILS_API_EXPORTING
10+
#define ALPHA_UTILS_API_DLL __declspec(dllexport)
11+
#else
12+
#define ALPHA_UTILS_API_DLL __declspec(dllimport)
13+
#endif
14+
#else
15+
#define ALPHA_UTILS_API_DLL __attribute__((visibility("default")))
16+
#endif
17+
18+
namespace AlphaUtils {
19+
class ALPHA_UTILS_API_DLL NodeModding {
20+
protected:
21+
std::unordered_map<std::string, std::vector<std::pair<int, std::function<void(cocos2d::CCNode*)>>>> m_nodesToModify;
22+
23+
public:
24+
static NodeModding* get();
25+
std::unordered_map<std::string, std::vector<std::pair<int, std::function<void(cocos2d::CCNode*)>>>> getNodesToModify();
26+
void addNodeToModify(std::string className, int prio, std::function<void(cocos2d::CCNode*)> func);
27+
void handleNode(cocos2d::CCNode* node);
28+
};
29+
30+
template <class Derived>
31+
struct NodeWrapper : public cocos2d::CCNode {
32+
geode::modifier::FieldIntermediate<Derived, cocos2d::CCNode> m_fields;
33+
static int modifyPrio() { return 0; }
34+
};
35+
36+
template <class T>
37+
class ModifyLoad {
38+
public:
39+
ModifyLoad(std::string str) {
40+
NodeModding::get()->addNodeToModify(str, T::modifyPrio(), [](cocos2d::CCNode* self) {
41+
reinterpret_cast<T*>(self)->T::modify();
42+
});
43+
}
44+
};
45+
}
46+
47+
//yoinked a lot of this from geode
48+
#define ALPHA_MODIFY_DECLARE(base, derived) \
49+
GEODE_CONCAT(GEODE_CONCAT(derived, __LINE__), Dummy);\
50+
struct derived;\
51+
class GEODE_CONCAT(GEODE_CONCAT(derived, Hook), __LINE__) : AlphaUtils::NodeWrapper<derived> {\
52+
private:\
53+
static inline AlphaUtils::ModifyLoad<derived> s_apply{#base};\
54+
};\
55+
struct derived : AlphaUtils::NodeWrapper<derived>
56+
57+
#define MODIFY1(base) ALPHA_MODIFY_DECLARE(base, GEODE_CONCAT(hook, __LINE__))
58+
#define MODIFY2(derived, base) ALPHA_MODIFY_DECLARE(base, derived)
59+
60+
#define $nodeModify(...) \
61+
GEODE_INVOKE(GEODE_CONCAT(MODIFY, GEODE_NUMBER_OF_ARGS(__VA_ARGS__)), __VA_ARGS__)

0 commit comments

Comments
 (0)