Skip to content
View wplacetool's full-sized avatar

Block or report wplacetool

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
wplacetool/README.md

WplaceTool

Essential toolkit for Wplace.live players. Free, open-source tools for color conversion, pixel art planning, and server monitoring.

Features

  • Convert HEX, RGB, or HSL colors to the closest match in the official Wplace palette
  • Real-time color preview and comparison
  • Click to copy color codes
  • Visual palette display with all official Wplace colors

πŸ–ŒοΈ Pixel Template Planner

  • Grid-based pixel art editor with official Wplace color palette
  • Zoom and pan functionality for detailed work
  • Export designs as PNG images
  • Save and load templates in JSON format
  • Mobile-responsive with touch controls
  • Drawing tools with left-click to draw, right-click to pan
  • Real-time monitoring of Wplace.live server status
  • Response time tracking
  • Uptime percentage calculation
  • Status history with timestamps
  • Auto-refresh every 30 seconds (optional)

Technology Stack

  • Framework: Next.js 15 with App Router
  • Language: TypeScript
  • Styling: Tailwind CSS
  • Icons: Lucide React
  • Build Tool: Turbopack (for development)

Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

  1. Clone the repository:
git clone <repository-url>
cd wplace_tool
  1. Install dependencies:
npm install
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 in your browser.

Build for Production

npm run build
npm start

Project Structure

wplace_tool/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/                 # Next.js App Router pages
β”‚   β”œβ”€β”€ components/          # React components
β”‚   β”‚   β”œβ”€β”€ ColorConverter.tsx
β”‚   β”‚   β”œβ”€β”€ PixelPlanner.tsx
β”‚   β”‚   β”œβ”€β”€ ServerStatus.tsx
β”‚   β”‚   β”œβ”€β”€ Navigation.tsx
β”‚   β”‚   └── Footer.tsx
β”‚   └── lib/                 # Utility functions
β”‚       └── wplace-colors.ts # Color palette and conversion utilities
β”œβ”€β”€ public/                  # Static assets
└── README.md

Key Features Details

Color Conversion Algorithm

Uses Euclidean distance in RGB color space to find the closest match in the Wplace palette:

distance = √[(r₁-rβ‚‚)Β² + (g₁-gβ‚‚)Β² + (b₁-bβ‚‚)Β²]

Pixel Planner Controls

  • Left Click/Drag: Draw pixels with selected color
  • Right Click/Drag: Pan around the canvas
  • Mouse Wheel: Zoom in/out
  • Touch: Full mobile support with pinch-to-zoom

Server Monitoring

  • Monitors wplace.live server availability
  • Tracks response times and uptime percentage
  • Maintains history of last 50 status checks
  • No-CORS requests for compatibility

Contributing

This is an open-source project. Contributions are welcome! Contribute List:

License

Free to use for the Wplace community.

Links

  • Wplace.live - Main Wplace website
  • Built for the Wplace community with ❀️

Pinned Loading

  1. WplaceBlueMarble-Chrome-Extension WplaceBlueMarble-Chrome-Extension Public

    Adapted for easy use as a Chrome extension, forked from SwingTheVine/Wplace-BlueMarble.

    JavaScript 5 1