pixel-plays README

README проекта с github.com/amirmushichge/pixel-plays. Одним файлом markdown: README.md.

Pixel Plays

Small browser games shown as isometric pixel dioramas. Every game is one page of plain JavaScript with its own software rasteriser: no build step, no dependencies, no sprites or image assets.

Play: https://pixel-plays-ruby.vercel.app/

Concept by abhi. Game by AmirMushich. Visual reference for the style: shawn.'s Small plays; no assets or subjects were copied.

Games

Game What you do Input
Balote Bocce against a bot, first to 5 Drag back and release; arrows + space
Stari Most Five dives off the old bridge, flip and enter the water vertically Hold and release
Rooftop Laundry Get the washing into the basket before the storm Drag; space
Tie-Break Clay-court tie-break against a bot, the moment you hit decides where the ball lands Tap; space
Mini Ramp 60 seconds on a skateboard ramp, pump for height and grab in the air Hold and release; space

Run

Requires Node.js; nothing to install.

node serve.mjs

Then open http://127.0.0.1:5300/. Any static file server works, and the site deploys as plain static files.

Add a game

Create <id>/index.html, load ../shell.js, call PixelPlays.mount({ id, rules }), set window.PP_SCENE, load ../engine.js, then add the game to GAMES in shell.js. The page needs a #mute button. Put its background track at <id>/<id>.mp3.

Visual rules

License

The code is under the MIT License. The music is not: see MUSIC.md.

pixel-plays (amirmushichge/pixel-plays)

Ищем в базе…

Что это?Сборник небольших браузерных игр, оформленных как изометрические пиксельные диорамы. Каждая игра — это одна HTML-страница без сборки и зависимостей, которая использует собственный небольшой программный растеризатор вместо спрайтов или изображений.
Это игровой движок или набор готовых игр?Это набор из пяти готовых игр, в которые можно играть: Balote, Stari Most, Rooftop Laundry, Tie-Break и Mini Ramp. Файлы shell.js и engine.js — общие вспомогательные модули для меню, музыки и отрисовки, а не универсальный движок для импорта в других проектах.
Как это запустить?Клонируйте репозиторий и раздайте папку любым статическим файловым сервером, затем откройте полученный адрес в браузере, так как весь сайт состоит из обычных статических файлов.
Нужны ли мне сборщик или библиотеки, чтобы этим пользоваться?Нет, ни сборщик, ни библиотеки не нужны: этапа сборки нет, npm-зависимостей нет, спрайтов и изображений тоже нет. Каждая игра рисует себя сама с помощью собственного программного растеризатора.
Можно ли свободно использовать фоновую музыку?Нет. Лицензия MIT распространяется только на код, а на музыку действуют отдельные условия, описанные в MUSIC.md.
Сколько здесь игр и что в них делать?Сейчас в комплекте пять игр: Balote (боччча против бота, побеждает первым, кто наберёт 5 очков), Stari Most (пять прыжков со скал с вертикальным входом в воду), Rooftop Laundry (перетащите бельё в корзину до начала грозы), Tie-Break (теннисный тай-брейк, где нужно нажимать в нужный момент) и Mini Ramp (60 секунд трюков на скейтборде).
Как добавить новую игру в проект?Создайте index.html, который подключает shell.js и engine.js. Вызовите PixelPlays.mount, передав id и rules, задайте window.PPSCENE и реализуйте функции groundColor, bake, update и draw. Добавьте кнопку #mute и фоновую дорожку, затем зарегистрируйте игру в списке GAMES в shell.js.
Откуда у игр такой узнаваемый пиксельный вид?Его создаёт программный растеризатор в реальном времени с буфером глубины, четырьмя уровнями затенения и дизерингом Байера. Камера фиксированная, ортографическая, под углом 30 градусов. Длинные жёсткие тени падают вправо от экрана, а цвета строятся градиентами со сдвигом оттенка: фиолетовые тени и тёплые жёлтые света. Всё выводится на холст низкого разрешения 360x280.
Какие есть похожие проекты?phaser, kindergrimm, ascii-sharks, PCB_lightgraph_Portable, signature_pad, riso-windowseat, konva, sylva
Автор
amirmushichge
Размер
11.7 MB
Звёзды
528
Обновлён
КоммитOct 31
Возраст
18 д
Коммиты · 90 дней