Giter Club home page Giter Club logo

griddycode's Introduction

GriddyCode

Coding has never been more lit!

preview.mp4

P.S. Press CTRL + I for a quick introduction in the Editor :)

Table of Contents

Requirements

Requirement Notes
Nerdfont - we use Nerdfont for the file picker. You'll know it's missing when your icons look like "□"
Linux - GriddyCode is tested mainly on Linux No, macOS won't be supported. Gaming OS works.

⌨️ Lua modding

GriddyCode allows you to extend its functionality via Lua.

Where?

To open the folder with Lua scripts, go to:

  • Windows: %APPDATA%\Godot\app_userdata\Bussin GriddyCode
  • macOS: ~/Library/Application Support/Bussin GriddyCode
  • Linux: ~/.local/share/godot/app_userdata/Bussin GriddyCode

Note: the paths are not accurate, we recommend you manually search for GriddyCode in the AppData of your OS.

How?

You may see the folders "langs" and "themes".

  • "langs" holds a bunch of .lua files that power GriddyCode's syntax highlighting & autocomplete.
  • "themes" holds a bunch of .lua files that change GriddyCode's appearance.

Note: the Lua scripts are reloaded only if you switch from a different file extension (i.e. "README.md" -> "main.ts"), or if GriddyCode is restarted.

Docs?

Langs

Introduction

To extend the functionality of GriddyCode for a specific file extension, create a file with its name. (i.e. toml.lua)

Methods

Method Example Description Notes
highlight(keyword: String, color: String) highlight("const", "reserved") Tells GriddyCode to highlight a certain keyword with a preset of colors. Available colors: reserved, annotation, string, binary, symbol, variable, operator, comments, error, function, member
highlight_region(start: String, end: String, color: String, line_only: bool = false) highlight("/*", "*/", "comments", false) Tells GriddyCode to highlight a region with a preset of colors. The start must be a symbol. Due to Godot's limited functionality, you can't use RegEx.
add_comment(comment: String) add_comment("What is blud doing 🗣️🗣️🗣️") Adds a comment to be randomly chosen in the CTRL + L menu. The username, profile picture, date, and likes are chosen by GriddyCode.
detect_functions(content: String, line: int, column: int) -> Array[String] detect_functions("const test = 3; function main() {}; async init() => { main() }") Called by GriddyCode upon input. Results are showed in the autocomplete feature. This must be provided by the Lua script. It must return an array of strings (i.e. ["main", "init"]). "line" and "column" are the position of the cursor when the autocomplete was requested.
detect_variables(content: String, line: int, column: int) -> Array[String] detect_variables("const test = 3;") Called by GriddyCode upon input. Results are showed in the autocomplete feature. This must be provided by the Lua script. It must return an array of strings (i.e. ["test"]). "line" and "column" are the position of the cursor when the autocomplete was requested.

Note: to provide reserved variables/functions (i.e. Math/parseInt() in JS) you can have them already set up in the array you return. GriddyCode will handle the rest!

Themes

Introduction

To add a theme, create a file in the "themes" folder with any name. (i.e. "dracula.lua"). You will be able to choose it within GriddyCode.

Methods

Method Example Description Notes
set_keywords(property: String, new_color: String) set_keywords("reserved", "#ff00ff") Set the color of syntax highlighting. The second argument must be a hex, # being optional. Available colors/properties listed above at langs.
set_gui(property: String, new_color: String) set_gui("background_color", "#ff00ff") This method is dedicated to the overall GUI aspect of GriddyCode. Available properties: background_color, current_line_color, selection_color, font_color, word_highlighted_color, selection_background_color. Properties except background_color, if not provided, will be set to a slightly modified version of background_color. Although possible, we don't recommend you rely on those & instead set all the values.
disable_glow() disable_glow() Disables the "glow" setting. This exists because Godot's glow seems to mess up on light colors. Not adding this on light themes may result in the entire screen going white.

Note: if the HEX you input is invalid, it will default to #ff0000 (red)

Publishing

If you want to use a theme/plugin for yourself, you can put it into your AppData.

If you want to submit a theme/plugin, open a pull request adding it to Lua/Plugins or Lua/Themes respectively. If merged, it will be included in the next build.

Contributions

Contributions are heavily appreciated, whether it's for adding Lua plugins, themes, safely exposing more features to Lua, or adding features directly to GriddyCode!

Notice

  • You will need to install the Godot Engine to run your proposed change & make sure it runs flawlessly.
  • You don't have to submit executables.
  • Use the v4.2 of the engine (currently Latest)

🐛 Current bugs/needed features:

HIGH PRIORITY

  • The VHS & CRT shader, on certain themes (One Dark Pro, GitHub Light, etc.), becomes completely white. Works good on GitHub Dark;
  • Light modes get affected by glow, while dark modes seem fine.

MEDIUM PRIORITY

  • An option in the settings menu (CTRL + ,) to change the font;
  • The current limit for lines is ~1600. If the cursor moves past that amount, the CodeEdit node will activate its scrolling, making the camera bug & go out of view. A limit should be implemented so that the camera won't go out of screen.

LOW PRIORITY

  • Making the cat jumping video in the settings menu fade in/out along the actual menu. Currently it ignores the transition;
  • CTRL + P to open a quick file picker, similar to VSCode.
  • Selecting a setting with the property "shader" should disable previously-enabled settings with "shader".
  • The CheckButton node for each setting scene doesn't change with the theme. This affects light themes specifically.

Please note that creating a Pull Request to fix these features does not guarantee its merge. Please don't open a Pull Request unless you are confident you've done a good job.

griddycode's People

Contributors

dropalways avatar elefantapan avatar face-hh avatar itstato avatar itsthatonejack avatar maxpixels64 avatar realpacket avatar ref1o avatar symmettry avatar uynilo9 avatar vpumpking avatar zsnails avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.