⚡ Pengu Plugins

A premium collection of plugins for League of Legends via Pengu Loader

---

📦 Plugins

Plugin	Version	Description
SoloQ Machine	0.0.1	Full ranked autopilot — queue, accept, honor, play again
Rune Plugin	0.0.4	Auto runes & item sets from U.GG / Lolalytics
Icon Swapper	0.1.0	Change your summoner icon to anything (client-side)
Profile Win/Loss	0.0.3	Win/loss stats on any profile page
Champion Dismisser	0.0.1	Blacklist champions from champ select
Mass Report	0.0.3	Batch reporting from match history
Force Badge	0.0.1	Game Pass badge on all champions & skins
ARAM Bot Enabler	0.0.1	Add bots to ARAM custom games
Instant Ranked Lobby	0.0.1	One-click ranked lobby (standalone)
Dodge Game	0.1.0	In-client 3D skillshot dodge mini-game
Pengu Family	0.1.0	Virtual pet pengu companion that lives in your client 🚧

---

🤖 SoloQ Machine

Your ranked autopilot. Automates the entire ranked flow so you can focus on the game.

What it does:

Feature	Details
Auto Accept	Accepts match with configurable delay
Auto Matchmaking	Starts queue automatically when entering lobby
Wait for Invites	Holds queue until pending invitations are answered
Min. Lobby Members	Requires N players (1–5) before starting queue
Auto Honor	Honors a random ally after game
Auto Play Again	Returns to lobby with configurable delay
Instant Ranked Lobby	Play button → ranked Solo/Duo lobby
UI Cleanup	Hides distracting elements (nav menus, social, notifications)

⚙️ Configuration

Click the settings gear icon (bottom-right corner of the client) to configure:

• Queue Automation — Auto Accept, Auto Matchmaking, delays, lobby conditions
• Post-Game — Auto Honor, Auto Play Again, play-again delay
• Lobby — Instant Ranked Lobby toggle
• UI — Hide Distracting Elements toggle
• Debug — Debug Logging toggle

---

🔄 Rune Plugin

Automatically fetches and applies optimal runes and item sets during champion select.

• 🎯 Fetches from U.GG or Lolalytics (configurable)
• 📦 Auto-creates item sets (most popular, highest winrate, situational)
• 🗺️ Role-specific configurations with automatic position detection
• ⚔️ Arena mode support
• ⚙️ Settings in client settings panel

📖 Usage

1. Enter champion select and pick your champion
2. Runes are auto-applied based on position + champion + latest patch
3. Item sets are created with popular/winrate builds
4. Configure provider and item sets in Settings → Rune Plugin

---

🎭 Icon Swapper

Change your summoner icon to any icon from Community Dragon or upload your own.

• 🌐 Browse all League icons from Community Dragon API
• 📂 Upload custom icons (local file or URL)
• 🔍 Search icons by ID
• 💾 Persistent via DataStore
• ↩️ One-click revert to default

📖 Usage

1. Press Ctrl+K → select Change Summoner Icon
2. Browse or search League icons, or switch to Custom Icons tab
3. Upload local files or paste image URLs
4. Click any icon to apply

---

📊 Profile Win/Loss

Win/loss statistics displayed directly on summoner profiles.

• 📈 Win rate, W/L count, and KDA stats
• 🔍 Filter by queue type (Ranked, Normal, ARAM, Swiftplay)
• 🗓️ Season 16 filter
• ⚙️ Configurable game count (1–200)

📖 Usage

1. Open any summoner profile — stats appear automatically
2. Configure in Settings → Profile Win/Loss:
   • Games to analyze, Queue Type, Season filter, KDA display

---

🚫 Champion Dismisser

Blacklist champions to prevent yourself from picking them.

• 🚫 Greyed-out & unclickable in champion select
• 🔍 Searchable configuration modal
• 💾 Persistent blacklist via DataStore
• 🗑️ Clear All button

📖 Usage

1. Press Ctrl+K → select Configure Blacklist
2. Search and click champions to toggle blacklist
3. Blacklisted champions appear greyed out in champ select

---

⚖️ Mass Report

Batch reporting from match history with whitelist protection.

• 🎯 Report all, enemy-only, or ally-only
• ⭐ Whitelist system to protect players
• 📝 Toast notifications for each report
• ⚙️ Settings in client settings panel

📖 Usage

1. Open a match in history → enter Game ID
2. Select target (All / Enemy / Ally)
3. Click Report

---

🏆 Force Badge

Shows the Game Pass rewards badge on all champions and skins.

• ✨ Badge on all champions in Collection and Champion Select
• 🎨 Reward flag on owned skins
• Zero configuration — works automatically

---

🤖 ARAM Bot Enabler

Add bots to ARAM custom games. (May not be working)

• Add bots to either team
• Choose champion and difficulty (Intro / Beginner / Intermediate)

---

⚡ Instant Ranked Lobby

Standalone version — instantly creates a ranked Solo/Duo lobby when pressing Play.

Note: This feature is already included in SoloQ Machine. Use this only if you want the lobby shortcut without the full suite.

---

🎮 Dodge Game

A native-feeling, in-client 3D mini-game. Pick one of 15 champions and dodge iconic skillshots from across Runeterra.

📖 Usage

1. Press Ctrl+K → select Launch Dodge Game (group: Dodge Game)
2. Choose a champion from the grid
3. Right-click to move (LoL-native); D = Flash, F = Ghost (rebind in Settings)
4. Escape to pause

On first launch the plugin pulls Three.js from esm.sh (~3 MB, cached) and the chosen champion's GLB from cdn.modelviewer.lol (~1–17 MB per champion, cached).

---

🐧 Pengu Family

🚧 Under Active Development — This plugin receives frequent updates with new features, improvements, and bug fixes. Bugs and occasional issues are expected while I polish the experience. See the Roadmap for upcoming plans.

A virtual pet penguin that lives in your League client. Raise it, feed it, play with it, and watch it react to your games.

• 🥚 5 Archetypes — Windblade, Shadow, Starlight, Chaos, Royal — each with unique personality & AI
• � Stat System — Hunger, Happiness, Energy decay over time; feed & pet to restore
• 🧠 Smart AI — Pengu wanders, follows/flees cursor, visits points of interest, reacts to game phases
• 🛒 Shop — Buy snacks, treats, energy drinks, toys, XP boosts, lullabies with earned coins
• 📋 Quests — Daily, weekly, and repeatable quests for coins & XP
• 🎮 Game Tracking — Earns XP & coins from wins/losses, reacts to victories and defeats
• 🗣️ Chat Bubbles — Personality-driven dialogue for idle chatter, moods, phases, hunger, and more
• 🌀 Fling Physics — Drag and throw your pengu with momentum, friction, and edge bouncing
• ⭐ Evolution — Baby → Adult → Elder stages as your pengu levels up

📖 Usage

1. Pengu appears automatically when you open the client
2. Double-click to pet · Right-click to open the Hub
3. Drag to move · release with speed to fling
4. Hub has 4 tabs: Status, Shop, Quests, Settings
5. Earn coins by playing games, complete quests for bonus rewards
6. Buy items from the shop to feed, boost, or put your pengu to sleep

---

🚀 Installation

📂 Pengu Loader/
└── 📂 plugins/
    ├── 📄 SoloQMachine.js
    ├── 📄 RunePlugin.js
    ├── 📄 IconSwapper.js
    ├── 📄 ProfileWinLose.js
    ├── 📄 ChampionDismisser.js
    ├── 📄 MassReport.js
    ├── 📄 ForceBadge.js
    ├── 📄 AramBotEnabler.js
    ├── 📁 DodgeGame/          ← folder-based plugin (copy the whole folder)
    │   ├── index.js
    │   ├── styles.css
    │   └── src/
    └── 📁 PenguFamily/        ← folder-based plugin (copy the whole folder)
        ├── index.js
        ├── styles.css
        ├── assets/
        └── src/

1. Install Pengu Loader
2. Copy desired plugin files (.js) or folder-based plugins (DodgeGame/, PenguFamily/) to your plugins directory
3. Restart the League client

---

🐛 Troubleshooting

1. Ensure Pengu Loader is up to date
2. Restart the League client
3. Enable Debug Logging in plugin settings for console output
4. Open DevTools with Ctrl + Shift + I to view logs

Report issues: GitHub Issues · hi@yimikami.me

Include: plugin name, version, steps to reproduce, expected vs actual behavior, and console logs.

---

Made with ❤️ for the League community

Report Bug · Request Feature