Installation¶

This guide will help you install NameMC Sniper and its dependencies on your system.

System Requirements¶

• Python: 3.8 or higher
• Operating System: Windows, macOS, or Linux
• Network: Stable internet connection
• Memory: At least 512MB RAM available

Installation Steps¶

1. Clone the Repository¶

git clone https://github.com/zwroee/NameMCSniper.git
cd NameMCSniper

2. Install Python Dependencies¶

pip install -r requirements.txt

# Create virtual environment
python -m venv namemc-sniper-env

# Activate virtual environment
# On Windows:
namemc-sniper-env\Scripts\activate
# On macOS/Linux:
source namemc-sniper-env/bin/activate

# Install dependencies
pip install -r requirements.txt

3. Verify Installation¶

Test that the installation was successful:

python Main.py --help

You should see the help menu with available commands.

4. Create Initial Configuration¶

Generate the default configuration file:

python Main.py config-create

This will create a config.yaml file in your project directory.

Dependencies¶

The main dependencies include:

• requests - HTTP library for API calls
• pyyaml - YAML configuration file support
• rich - Beautiful terminal output
• discord.py - Discord bot integration (optional)
• schedule - Task scheduling
• colorama - Cross-platform colored terminal text

Verification¶

To ensure everything is working correctly:

1. Check version:

   python Main.py version
   

2. Validate configuration:

   python Main.py config-validate
   

3. Test proxy connections (if using proxies):

   python Main.py test-proxies
   

Troubleshooting Installation¶

Common Issues¶

Python not found

# Make sure Python is in your PATH
python --version
# or try
python3 --version

Permission errors

# On Windows, run as administrator
# On macOS/Linux, use sudo if needed
sudo pip install -r requirements.txt

Module not found errors

# Ensure you're in the correct directory
ls -la  # Should show Main.py and requirements.txt
# Reinstall dependencies
pip install -r requirements.txt --force-reinstall

Next Steps¶

Once installation is complete, proceed to Configuration to set up your sniper settings.