EyeModPhone

# 📱 EyeMod — A Fully Functional Phone for Minecraft > *Message friends, snap photos, play games, and more — all from inside Minecraft.* EyeMod brings a working, realistic smartphone experience to your world. Whether you're running a bustling SMP or a solo survival world, the EyePhone packs a wide range of apps to keep you connected and entertained. > 💡 **Tip:** Keep a **Powerbank** in your inventory to extend your battery life! --- ## ✨ Features - 💬 **Messaging** — Chat with other players directly through the phone - 🎮 **Mini-games** — Play games right on your EyePhone - 📸 **Camera & Photo Editing** — Take and edit in-game pictures - 🗺️ **Maps, Notes, Shops, Spawns** — A full suite of utility apps - ⚙️ **Highly configurable** — Tailor almost everything to your server or world > **1.20+ Note:** OP/cheat apps (like the TNT app) have been removed from the default app selection to make server installs safer out of the box. These will return as a separate companion mod in a future update. --- ## ⚙️ Configuration The config file lives in your `.minecraft/config/` folder (or your server directory). Most of the mod's behavior can be tweaked there. ### App IDs Many config options require an **app ID**, which follows this format: ``` : ``` The mod ID is `eyemod`, and the app name is usually the app's display name with spaces replaced by underscores. For example, the Maps app ID is `eyemod:maps`. > 💡 **Pro tip:** Run `/data get entity @p SelectedItem` while holding an EyePhone to inspect all installed app IDs directly from the NBT data. --- ## 🛒 Shops Shops are **disabled by default**. To enable them: 1. Open your config file 2. Set `allowShopApps` to `true` This unlocks the **Food Shop** and **Util Shop** apps on the EyePhone. You can customize the items sold in each shop via the `foodShop` and `utilShop` lists, and change the accepted currency using the `currency` property (default: **Emeralds**). --- ## 🏠 Spawn Locations The Spawn app lets you list predefined teleport destinations — perfect for a spawn hub, nether portal, or end gateway. Add them in the config like this: ``` ["Spawn=1/2/3/minecraft:overworld", "Nether=1/2/3/minecraft:the_nether"] ``` Players can also set a personal **Home** location. Teleportation is disabled by default — enable it with: - `allowHome` — lets players teleport to their home - `allowSpawns` — lets players teleport to predefined spawn points --- ## 🔒 App Access Control Control which apps are available and to whom using the `access` config list: | Value | Behavior | |-------|-----------| | `0` | Enabled for all players *(default)* | | `1` | Enabled for OPs only | | `2` | Completely disabled | **Example:** ``` ["eyemod:maps=1", "eyemod:notes=2"] ``` To disable all cheat-tagged apps at once, set `disableCheatApps` to `true`. --- ## 💰 App Pricing App prices work the same way as access control — just use the price instead of an access level: ``` ["eyemod:maps=100", "eyemod:notes=0"] ``` --- ## 💾 Storage EyePhone data is stored as NBT, so there's a per-phone character cap to keep things performant. If the cap is hit, data is automatically cleared. - Adjust the cap with the `maxStorage` property - For large servers, consider **lowering** this value - Players can manually clear app data from the **Settings app** > Storage is calculated at ~2 bytes per character. --- ## 🖥️ Server Setup EyeMod is fully server-compatible. Here's what server owners and operators should know: ### 🚫 Banning Players Since the EyePhone allows free player-to-player communication, abuse can happen. Operators can **ban a player from using the EyePhone** directly through the Settings app by entering their username. Banned players lose access to all communication features. ### 📂 Data Storage Player data is stored **per world** and includes: - 💳 Account info (money, purchased apps) - 💬 Messages (up to **64 per player, per app**) - 🚫 Ban list - 📋 Board and chat messages > ⚠️ **Warning:** Deleting the world data file removes all of the above permanently.