BlockyTK

BlockyTK is a graphical user interface (GUI) overlay for Minescript, allowing you to manage, configure, and run your Python automation scripts directly from within Minecraft.

Features

• In-Game GUI: A modern, dark-themed overlay (built with customtkinter) that sits on top of your Minecraft window.
• Script Manager: Browse automatically categorized scripts found in your minescript/scripts/ folder.
• One-Click Execution: Start and stop scripts with a "Run/Stop" button.
• Visual Configuration: Configure script parameters (numbers, booleans, dropdowns) using sliders and switches—no code editing required.
• Hotkeys: Bind scripts to keyboard shortcuts for instant activation.
• Portable: Uses a local lib/ folder for dependencies, keeping your installation clean and self-contained.

Installation

Prerequisites

• Minecraft with the Minescript mod installed.
• Python 3.x installed and configured in Minescript's config.txt.

Setup

1. Download: Download this repository and place the contents into your Minescript folder.

   • Path: %appdata%\.minecraft\minescript\ (or your specific profile's minescript folder).

2. Install Dependencies: BlockyTK relies on customtkinter, which is not included by default. To make installation easy and portable, we've provided a helper script.

   Open a terminal in your minescript folder and run:

   python install_dependencies.py
   

   This will install the required libraries into a local lib/ folder, ensuring the Hub works immediately without needing to modify your global Python environment or Minescript's PYTHONPATH.

Usage

1. Start the Hub: In Minecraft, open the chat and type:

   \gui_launcher
   

   Note: The first time you run this, it might take a moment to initialize.

2. Toggle the Menu: Once loaded, you will see a message: "BlockyTK loaded. Press R-Shift to toggle." Press Right Shift to open/close the menu.

3. Running Scripts:

   • Browse: Use the sidebar to find scripts by category.
   • Configure: Click "Configure" to change settings (e.g., bridge material, build delay).
   • Run: Click the "Run" button to start the script. The button will change to "Stop" while it is running.

4. Shortcuts:

   • Go to a script's "Configure" page.
   • Click the Shortcut button.
   • Press any key to bind that script to the key.
   • You can now trigger that script anytime by pressing that key (even when the menu is closed).

Writing Scripts for the Hub

To make your own scripts appear in the Hub, they must export a UI_CONFIG using the ScriptUI helper.

Here is an example using bridge.py (found in scripts/bridge.py):

1. Create a new .py file in minescript/scripts/.
2. Import minescript and minescript_ui.
3. Define your UI and run function:

import minescript
import time
import math
from minescript_ui import ScriptUI

# 1. Define UI
ui = ScriptUI("Auto Bridge", category="Travel", description="Automatically places blocks under your feet if there is air.")
ui.dropdown("material", "Material", ["stone", "cobblestone", "dirt", "oak_planks", "glass"], default="cobblestone")
ui.float("delay", "Check Delay", default=0.05, min=0.01, max=0.5)

# 2. Export Config
UI_CONFIG = ui.export()

# 3. Main Logic
def run(params, stop_event):
    mat = params['material']
    delay = params['delay']
    minescript.echo(f"🌉 Bridge Builder Active ({mat}). Walk carefully!")
    
    while not stop_event.is_set():
        px, py, pz = minescript.player_position()
        
        # Block immediately below feet
        # Use math.floor(py) - 1 for block under feet
        bx, by, bz = round(px), math.floor(py) - 1, round(pz)
        
        # "setblock x y z block keep" only places if air.
        minescript.execute(f"setblock {bx} {by} {bz} {mat} keep")
        
        if stop_event.wait(delay): break
        
    minescript.echo("🛑 Bridge Builder Stopped.")

Configuration

• config.txt: Standard Minescript configuration.
• gui_config.py: Generated file storing your shortcuts and Hub preferences. Do not edit manually unless necessary.

Troubleshooting

• "Module not found": Run python install_dependencies.py again to ensure lib/ is populated.
• Menu not showing: Check the chat for errors. Ensure you are running \gui_launcher, not \gui_launcher.py.

🎮 Minescript C2 (Command & Control)

Minescript C2 is a powerful, web-based dashboard for Minescript that allows you to control your Minecraft automation scripts remotely.

It features a modern "Command and Control" interface with live chat, real-time inventory monitoring, and one-click script execution—all from your browser.

✨ Features

• Two Operating Modes:
  • 🏠 Internal Mode: Hosts the dashboard directly from your Minecraft client (localhost).
  • ☁️ External Mode: Connects to a remote relay server, allowing you to control your player from anywhere (e.g., via ngrok or a VPS).
• 📂 Script Manager: Automatically detects and loads Python scripts from your scripts/ folder.
• 💬 Live Communication: View and send chat messages from the web interface.
• 🎒 Real-time Inventory: Monitor your player's inventory updates live.
• 🛑 Emergency Stop: Kill all running automation jobs instantly.
• 📦 Auto-Dependency Management: Self-contained lib/ folder installation.

📦 Installation

1. Download the Code: Clone this repository or download the source code.

2. Install Dependencies: Run the setup script once to install necessary libraries (websocket-server and websocket-client) into the local lib/ folder.

   # In your Minescript console
   \setup
   

   Note: The dashboard is self-contained. It installs dependencies locally so you don't need to mess with your global Python environment.

🚀 Usage

Option 1: Internal Mode (Localhost)

Best for single-player or local testing. The dashboard runs on your PC.

1. Create a start.py file:

   from dashboard import Dashboard
   
   # Starts Web Server on port 8000 and WebSocket on 8999
   dash = Dashboard(
       external=False, 
       script_folder="./scripts",
       auto_open=True # Automatically opens your browser
   )
   dash.start()
   

2. Run \start in Minecraft.
3. Your browser will open to http://localhost:8000.

Option 2: External Mode (Remote Control)

Best for controlling your account remotely or sharing access.

1. Start the Relay Server on your PC or VPS (standard Python, not inside Minecraft):

   python relay_server.py
   

2. Start the Minecraft Client:

   from dashboard import Dashboard
   
   dash = Dashboard(
       external=True,
       host="localhost", # Or your VPS IP / ngrok URL
       port=9000,        # Relay WebSocket port
       script_folder="./scripts"
   )
   dash.start()
   

3. Open http://localhost:3000 (or your relay URL) to control your Minecraft client.

📂 Project Structure

minescript-c2/
├── dashboard.py       # Core library (Web & WebSocket servers)
├── job_manager.py     # Handles loading and running background jobs
├── setup.py           # Dependency installer
├── relay_server.py    # (Optional) Standalone server for External Mode
├── ui/                # (Generated) Web frontend files
├── lib/               # (Generated) Local Python dependencies
└── scripts/           # PUT YOUR SCRIPTS HERE
    ├── mining.py
    ├── fishing.py
    └── ...

🛠️ Creating Custom Scripts

Add any .py file to the scripts/ folder. It must have a run(stop_event) function.

Example: scripts/hello.py

import minescript
import time

def run(stop_event):
    minescript.echo("Job started!")
    
    while not stop_event.is_set():
        # Do work here
        minescript.echo("Working...")
        
        # Use wait() on the event instead of time.sleep() for responsive stopping
        if stop_event.wait(5): 
            break
            
    minescript.echo("Job stopped.")

🤝 Contributing

Feel free to submit issues or pull requests.

AShortPath

A lightweight path-finding Minecraft bot for the Minescript modloader. AShortPath uses the Theta* algorithm to produce smooth, short routes in voxel worlds—often shorter than classic A* paths thanks to line-of-sight shortcuts.

Credit & inspiration: hyshenn/thetaSTAR

Features

• 🚀 Fast, greedy-any-angle routing with Theta*
• 🧭 Simple, minimal API (path_find, path_walk_to)
• 🧱 Works directly with Minecraft (x, y, z) block coordinates
• 🧠 Automatically handles “no path” cases

Quick Start

Create a small Minescript script and run it in your world:

from AShortPath.thetastar import path_walk_to, path_find
import minescript

# Start at player position; set your target coordinates here:
start = minescript.player_position()
goal = (600, 72, 1200)

path = path_find(start, goal)

if not path:
    minescript.echo("No path found.")
else:
    minescript.echo(f"Path length: {len(path)}")
    # Walk the computed path.
    path_walk_to(path=path, distance=1)

What you’ll see

• If a path exists, the bot walks it and prints the path length in chat.
• If no path exists (e.g., blocked or unreachable), you get a clear message instead.

Installation

AShortPath is a pure-script drop-in.

1. Copy the AShortPath/ folder into your Minescript scripts directory (or any location that is on your Minescript/Python path).

2. Import it from your script:

   from AShortPath.thetastar import path_find, path_walk_to
   

If your environment uses a custom loader, make sure AShortPath is importable (e.g., added to PYTHONPATH or your Minescript modules directory).

API

path_find(start, goal) -> list[tuple[int, int, int]] | None

Compute a path between two block coordinates.

• start: (x, y, z) – typically minescript.player_position()
• goal: (x, y, z) – your destination
• returns: A list of (x, y, z) waypoints, including start/goal, or None if unreachable.

path_walk_to(path, distance: int = 1) -> None

Walk an existing path.

• path: The list returned by path_find
• distance: Stop when within this many blocks of the goal (default 1)

Separation of concerns: compute once with path_find, then hand the path to path_walk_to. This lets you inspect/modify the path before moving (e.g., visualize or trim it).

How It Works (In Short)

AShortPath uses Theta, an any-angle variant of A:

• It performs line-of-sight checks between a node and its parent, letting it “cut corners” across free space.
• The result is typically shorter and smoother than grid-constrained A* paths.
• The world is treated as a voxel grid using collision checks to avoid solid blocks.

Tips & Gotchas

• Coordinate system: Use integer (x, y, z) block positions.
• Performance: Planning cost grows with search radius and obstacle density. Prefer realistic goals over extreme distances when possible.

Contributing

Bug reports and improvements are welcome! Please keep contributions focused and well-scoped (small PRs are easier to review and test).

Credits

• Algorithm: Theta*
• Inspiration & basis: hyshenn/thetaSTAR

Litematica Excel

TXT to Excel parser for Litematica's material list.

Download

🟢 Stable release

Features

• Automatically create an Excel file from your material list.
• Use a formula so the Missing gets lower the more of the materials you have available.
• Remove excessive data in txt file.

How it works

1. Compile or download this project (Download can be found on the release page).
2. Open the program.
3. Press enter and select the material files.
4. Wait while the program finishes converting.
5. Close the program and enjoy the excel file which can be found in the programs folder.

Example

Contributor

Thanks to this amazing contributor:

@tlorius
🛠️

About The Project

The FileSafe project is a robust file protection application designed to safeguard your important files. It offers a range of powerful features to ensure your data's privacy and security. Whether you want to simply hide files, encrypt them, or even secure the binary files, FileSafe has you covered.

Features

• Hide Files: FileSafe can make all files within its directory invisible and inaccessible through regular file explorers.

• EncryptBinFile: This feature encrypts the entire binary file containing the file binaries, ensuring that even if someone tries to access the binary file directly, the contents remain secure and unreadable without the correct password.

• Change Password: Easily modify the password used to lock and unlock the hidden files for enhanced security.

(back to top)

Getting Started

If you want to experience the security and convenience of FileSafe, follow these simple steps to get started:

Installation

1. Download:

   • Download the latest release of FileSafe from the official GitHub repository.

2. Run the Executable:

   • Locate the FileSafe executable file.
   • Run the executable to launch FileSafe on your system.

3. Password Setup:

   • During the initial setup, you'll be prompted to set a password for locking and unlocking your hidden files. Ensure you choose a strong and memorable password for maximum security.

(back to top)

How to Use

FileSafe provides a straightforward user interface with the following key features:

• Lock: This feature hides all files within the directory where the FileSafe executable is placed. It makes them invisible and inaccessible through regular file explorers.

• Unlock: Use this feature to access your hidden files. You'll be prompted to enter the correct password set during the initial setup. Once the correct password is provided, all hidden files become visible and accessible again.

• Change Password: Easily modify your password by accessing the "Change Password" option within FileSafe.

(back to top)

Settings

FileSafe offers three settings to customize your file protection preferences:

• Strictly Hide Files: Select this option to only hide the files within the directory without encrypting them. The files remain in their original state.

• Hide and Encrypt Files: This option not only hides the selected files but also encrypts them using a secure encryption algorithm, providing a higher level of security for your sensitive data.

• EncryptBinFile: By choosing this option, FileSafe encrypts the entire binary file containing the file binaries, ensuring the contents remain secure and unreadable without the correct password.

(back to top)

Security Reminder

Remember to keep your password secure and avoid sharing it with unauthorized individuals. If you forget your password, it might be impossible to recover the hidden files, especially if they are encrypted. So, always keep a backup of important files outside of FileSafe if needed.

Enjoy using FileSafe to protect your valuable files and maintain your privacy!

(back to top)

About The Project

[]

The Sudoku Solver is a software application that solves Sudoku puzzles using a backtracking algorithm. It provides a graphical user interface (GUI) for users to interact with and solve Sudoku puzzles.

This Sudoku Solver project provides an interactive and efficient way to solve Sudoku puzzles using a desktop application. It is designed to enhance the puzzle-solving experience by automating the solution process and offering a user-friendly interface.

(back to top)

Built With

This section should list any major frameworks/libraries used to bootstrap your project. Leave any add-ons/plugins for the acknowledgements section. Here are a few examples.

• Programming Language: C#
• Framework: .NET Framework
• GUI Development: Windows Forms
• JSON Parsing: Newtonsoft.Json

  (back to top)

Getting Started

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

Installation

To install and run the Sudoku Solver application on your machine, follow these steps:

1. Prerequisites:

   • Make sure you have the .NET Framework installed. You can download it from the official Microsoft website.
   • Ensure you have a compatible operating system (e.g., Windows 11, Windows 10, Windows 8.1, Windows 7).

2. Download:

   • Download the latest release of the Sudoku Solver application from the project's GitHub repository.

3. Extract the Files:

   • Extract the downloaded ZIP file to a directory of your choice.

4. Run the Application:

   • Navigate to the extracted directory and locate the executable file (e.g., Sudoku_Solver.exe).
   • Double-click on the executable file to run the application.

5. User Interface:

   • The Sudoku Solver application will open with the main GUI, displaying the Sudoku grid.

(back to top)

Usage

• Load a Sudoku puzzle by clicking on the "Load Random" button to fetch a random puzzle or use the "Clear" button to start with an empty grid.
• Fill in the empty cells with numbers from 1 to 9.
• Click the "Solve" button to solve the puzzle. If a solution is found, the solved puzzle will be displayed in the grid.

Enjoy solving Sudoku puzzles with the Sudoku Solver application!

(back to top)

Roadmap

• Graphical User Interface (GUI): The program has a user- [x]friendly interface built using Windows Forms in C#. It allows users to interact with the Sudoku grid visually.
• Puzzle Generation: The program can generate Sudoku puzzles by fetching data from an API or using a predefined template. Users have the option to load a random puzzle or start with an empty grid.
• Puzzle Solving: The application uses a backtracking algorithm to solve the Sudoku puzzle. It provides a Solve button that attempts to find a solution for the given puzzle.
• Input Validation: The program validates user input to ensure that only valid numbers from 1 to 9 are entered in the Sudoku grid. It displays error messages for invalid input.
• Visual Representation: The Sudoku grid is displayed using a table- [x]like structure with text boxes for each cell. Filled cells are shown with a dark gray background, while empty cells are displayed with a white background.
• Solution Display: Once the puzzle is solved, the program displays the solved puzzle in the Sudoku grid, highlighting the solution cells.

See the open issues for a full list of proposed features (and known issues).

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Voczel v1

Easy and Customizable voice assistant.

Download

🟢 Stable release

Features

• Has prebuild commands.
• Uses custom commands which can be programmed in C#.
• Custom commands get imported directly.

Prebuild Commands

• Voczel (Starts the Listener and waits for its command)
• Stop Listening (Stop the listener)
• Shutdown (Shuts down Voczel)
• Mute (Mutes Voczel)
• Unmute (Unmutes Voczel)
• Reload Commands (Reloads all custom commands)
• Hide (Hides Voczel into your system tray)
• Unhide shows Voczel on your screen)

Custom Commands

How it works

Make a .cs file in the Commands directory.
After making that, Restart Voczel or ask Voczel to "Reload Commands"

Example

Close all Chrome processes:

using System;
using System.Diagnostics;
using System.Speech.Synthesis;
class MyScript
{

    static SpeechSynthesizer speech = new SpeechSynthesizer();

    public void ExecuteAFunction()
    {

        Process[] chromeInstances = Process.GetProcessesByName("chrome");

        foreach (Process p in chromeInstances) {
            p.Kill();
        }
        speech.SpeakAsync("Closed all chrome windows for you.");
    }
}