Шаблон
Ctrl+Enter — запустить
Поле игры
Не запущена
Нажмите «Запустить» — программа появится здесь.
Щёлкните по полю, чтобы управлять с клавиатуры; Tab — уйти с поля
Щёлкните по миру: мышь — смотреть, WASD — ходить, пробел — прыжок, F — полёт, левая/правая кнопка — сломать/поставить, 1–9 — блок, E — рюкзак (в выживании), Esc — отпустить мышь
Палец по миру — смотреть; кнопки внизу — ходить, прыгать, ломать и ставить; «Блок ›» или касание панели — другой блок
Тяните мышью или пальцем — повернуть сцену; колесо или два пальца — приблизить; Shift — сдвинуть; двойной щелчок — вернуть вид
Шпаргалка
Игра — это две функции: draw() рисует кадр, update(dt) двигает мир. Студия вызывает их сама 60 раз в секунду — свой цикл while True писать не нужно (и нельзя: игра зависнет и будет остановлена).
Программа строит мир: world.terrain(), world.set(x, y, z, 'stone'), world.fill(…); y — вверх. Потом в мире можно ходить, ломать и ставить блоки. Если в программе есть def on_break, on_place, on_step, on_key или update — она отвечает на действия игрока, и получается игра.
Модель — обычная программа: создайте фигуры, а потом в цикле while шаг за шагом меняйте скорости и положения. В начале цикла пишите rate(100) — не больше 100 шагов в секунду; без него сцена не обновится, и программа будет остановлена через 2,5 с. Сцену можно вращать мышью и после конца программы.
Картинки
Встроенные картинки для актёров: Actor('hero', (400, 300)). На поле каждая — 48×48 точек. «PNG» — скачать картинку для игры на своём компьютере.
Звуки
Короткие звуки для событий игры. В браузере звук включается после первого нажатия клавиши или щелчка по полю.
Блоки
Название блока пишется в кавычках: world.set(x, y, z, 'brick') или по-русски 'кирпич'. world.get возвращает английское название. Текстуры нарисованы для СильверБлока. Ниже — инструменты для мирного выживания: player.give('iron_pickaxe').
О мире СильверБлок
- Мир — 128 × 64 × 128 блоков:
x и z от 0 до 127 (по земле), y от 0 до 63 (вверх). Края мира — невидимая стена; упавший вниз игрок возвращается на точку появления.
- Сначала программа выполняется целиком и строит мир (
sleep() показывает стройку по шагам). Если в ней есть обработчики событий, программа продолжает работать и отвечает на действия игрока; иначе мир остаётся — по нему можно ходить и строить руками.
world.terrain(seed) — один и тот же мир при одном и том же зерне: удобно для заданий класса.
- Небо живое: время идёт само (сутки — 20 минут,
world.day_length), солнце и луна с фазами ходят по небу, ночью — звёзды и падающие звёзды, иногда северное сияние. Погода — world.weather: дождь, снег, гроза с молниями, туман; после дождя бывает радуга.
- Мирное выживание (
world.mode = 'survival'): блоки добываются, пока держите кнопку, и падают в рюкзак (E); камень и руды — только киркой, дерево — топором быстрее, землю — лопатой. Инструменты четырёх уровней (дерево, камень, железо, серебро) делаются на верстаке и изнашиваются. Монстров и урона нет.
- Животные и жители: овцы, куры, кролики, коровы, кошки и жители —
Mob('овца', x, y, z). Они бродят, идут к точке, ходят следом, говорят; щелчок по ним — событие on_mob_click. Обидеть их нельзя — только погладить.
- Программа работает в изолированном поле: сети и файлов нет. Если программа 4 с ничего не меняет в мире или обработчик идёт дольше 1,5 с, она останавливается с объяснением.
- Кнопка «Поделиться» сохраняет программу на сайте вместе с миром: всё, что вы построили и сломали руками, увидит тот, кому вы отправите ссылку. Если изменить программу, мир снова построит она.
- Агент — робот-строитель:
agent.move(FORWARD, 3), agent.turn(TurnDirection.LEFT), agent.place(DOWN), agent.detect(AgentDetection.BLOCK, FORWARD) — те же команды, что в MakeCode для Minecraft Education, поэтому код с уроков обычно работает и здесь. Агент идёт по шагам — видно, как работает алгоритм. Команды чата: player.on_chat('стена', wall), в мире — T и «стена 6 3».
- Помощник «Опиши мир» (над редактором, после входа): опишите словами мир или правку — ИИ напишет программу на Python. Перед тем как принять, видно, какие строки изменятся; программу можно читать и менять дальше самому. До 100 запросов в день; учитель может выключить помощника для класса.
- Задания с автопроверкой: учитель добавляет в тест, урок или курс «Задание СильверБлока» — ученик пишет программу в мире задания, «Проверить решение» запускает её в каждом испытании, сайт засчитывает постройку или путь Агента и ставит баллы в журнал класса.
- Мир класса: учитель открывает общий мир на урок («Игровые механики» → «Миры класса»), ученики входят по PIN — у каждого свой участок: строят руками и программой (
plot.x, plot.z — угол участка), учитель видит всех, может остановить игру и откатить постройки.
- Логика на проводах: провод, рычаг (правая кнопка — переключить), вентили И, ИЛИ, НЕ, «исключающее ИЛИ», лампа и дверь. У вентиля входы — сбоку и снизу, выход — вверх: лампа на вентиле показывает ответ.
world.powered(x, y, z) — есть ли сигнал, world.toggle(x, y, z) — переключить рычаг: программа сама строит таблицу истинности (шаблон «Логика»). В мире класса учитель может дать задание «схема на рычагах: лампа = A and not B» — сайт сам перебирает все положения рычагов.
- Время, погода, рюкзак и существа в ссылку не сохраняются — их задаёт программа.
Как запустить модель на своём компьютере
Программы «Физики 3D» написаны на командах VPython — их можно запустить без изменений в двух местах.
- В браузере, на сайте Web VPython: glowscript.org → войдите, создайте программу и вставьте код. Первую строку
from vpython import * замените на Web VPython 3.2.
- В обычном Python: установите Python с python.org, затем в командной строке:
pip install vpython. Сохраните программу в файл model.py и запустите: python model.py — сцена и графики откроются во вкладке браузера.
Чем студия отличается от VPython
- Нет событий мыши и клавиатуры (
scene.bind, scene.waitfor) и элементов управления (button, slider, menu) — программа идёт дальше, а в консоли появляется примечание.
- Нет
compound, extrusion, text, текстур и настройки света; у curve линия всегда тонкая.
- Не больше 5000 фигур, 300 тысяч точек в линиях и следах и 4 графиков.
- Если 2,5 с сцена не обновлялась (в цикле нет
rate()), программа останавливается. Сеть и файлы недоступны.
Как запустить игру на своём компьютере
- Установите Python с python.org, затем в командной строке:
pip install pgzero
- Сохраните код игры в файл, например
game.py.
- Рядом создайте папку
images и положите туда картинки из вкладки «Картинки» (кнопка «PNG»), с теми же именами: hero.png, coin.png…
- Запустите:
pgzrun game.py. Или допишите в конец файла две строки и запускайте как обычную программу:
import pgzrun
pgzrun.go()
Звуки студии синтезируются в браузере, файлов у них нет. Для Pygame Zero положите свои .wav или .ogg в папку sounds с теми же именами (coin.wav) — или уберите строки со звуками.
Чем студия отличается от Pygame Zero
- Позиция актёра — всегда его центр (
anchor не меняется).
- Нет
music, tone, animate и загрузки своих файлов; шрифт текста — системный.
- Если кадр выполняется дольше 1,5 с, игра останавливается; программа должна запуститься за 5 с.
- Сеть и файлы недоступны: игра работает в изолированном поле.