Практическое руководство

Черепашка CC: Tweaked

Запустить черепашку CC: Tweaked: терминал, Lua, топливо, движение, добыча, выгрузка в сундук и обработка ошибок программы.

На странице 11 разделов

Коротко

Черепашка выполняет Lua-программы через turtle API. Начните с короткого движения туда и обратно: проверяйте результат каждого действия, расход топлива и свободное место в инвентаре.

Пример: CC: Tweaked 1.120.2, Java 1.20.1 Forge. Учебная программа использует базовые вызовы turtle API и не скачивает код из интернета.

Схема примера

Проверить топливо → Сохранить программу → Проверить движение → Вернуться назад

Поясняющая схема последовательности действий; это не снимок интерфейса игры.

Собрать и открыть черепашку

  1. Установите CC: Tweaked под свою игру и загрузчик.
  2. Найдите в JEI Turtle и подходящий вариант с инструментом, если планируете добычу.
  3. Поставьте черепашку перед свободной клеткой и откройте её терминал.
  4. Прочитайте встроенную справку командой help и проверьте управление терминалом.
  5. Для первого опыта выберите ровную безопасную площадку без сундуков и ценных построек впереди.

Проверить топливо

  1. Поместите подходящее топливо в выбранный слот черепашки.
  2. В Lua или программе вызовите turtle.refuel и проверьте, получилось ли пополнение.
  3. Посмотрите turtle.getFuelLevel: при отключённом расходе топлива он может вернуть строковое состояние вместо числа.
  4. Планируйте запас на путь к цели и возвращение. Повороты и движение — разные действия.
  5. Не рассчитывайте, что предмет в инвентаре сам превратится в топливо без команды.

Сохранить и запустить программу

  1. В терминале выполните edit hello.
  2. Введите программу из примера, сохраните её и выйдите из редактора.
  3. Запустите файл командой hello.
  4. Проверьте движение вперёд и возвращение. Если действие не удалось, программа должна показать причину.
  5. После успешной проверки меняйте по одному действию.

hello.lua: одно движение и возврат

local fuel = turtle.getFuelLevel()
if type(fuel) == "number" and fuel < 2 then
  local ok = turtle.refuel(1)
  if not ok or turtle.getFuelLevel() < 2 then
    error("Need fuel for return")
  end
end
local ok, reason = turtle.forward()
if not ok then error(reason or "Forward blocked") end
sleep(1)
ok, reason = turtle.back()
if not ok then error(reason or "Return blocked") end
print("Returned")

Пример не добывает блоки: он сначала проверяет безопасное движение.

Добавить добычу и выгрузку

  1. Для добычи используйте черепашку с подходящим инструментом и вызов turtle.dig.
  2. После добычи проверяйте результат turtle.forward; копание и перемещение — отдельные операции.
  3. До длинной работы контролируйте свободные слоты и топливо на обратный путь.
  4. Для выгрузки повернитесь к сундуку и используйте turtle.drop; проверьте его результат и остаток предметов в слоте.
  5. Если сундук заполнен или действие запрещено защитой, остановите программу с понятным сообщением.

Сохранение программы и безопасный возврат

  1. Перед длинным маршрутом сохраняйте координаты или последовательность перемещений, а не только общий счётчик.
  2. Не перезапускайте прерванную программу как будто черепашка всё ещё стоит в начальной точке.
  3. Для автоматического старта используйте документированный механизм startup только после ручной проверки.
  4. Храните копию программы отдельно. При замене черепашки проверьте её данные и назначение в мире.

Если не работает

ПроблемаЧто проверить
turtle API отсутствуетПрограмма запущена на обычном компьютере или вне CC: Tweaked. Нужен Turtle.
forward возвращает falseВпереди препятствие, сущность, граница разрешённой области либо не хватает топлива. Выведите причину вызова.
dig не ломает блокПроверьте инструмент, добываемость блока и защиту территории.
drop оставляет предметыПроверьте направление, ёмкость сундука и результат операции. Нельзя считать выгрузку успешной только потому, что вызов был сделан.

Источники и версии

Релиз gRtcHJd8 подтверждён Modrinth. Скрипт ниже предназначен для Turtle, а не обычного Computer. Добыча требует подходящего инструмента черепашки; защищённые блоки и приват сервера могут запретить действие.

Справка сверена 31 октября 2026 года. Перед установкой выбирайте файл для своей версии игры и загрузчика.

Частые вопросы

Топливо расходуется при каждом повороте?

В стандартном режиме топливо связано с перемещением, а повороты являются отдельными действиями. Правила конкретного сервера и мода проверяйте в настройках.

Можно ли выполнять Lua-код из интернета?

Можно работать с внешними программами, но сначала прочитайте их и проверьте в отдельном мире. Для первого запуска достаточно локального примера.

Почему черепашка не вернулась после перезапуска?

Программа и мир могли остановиться в промежуточной точке. Без сохранённого состояния она не знает, какую часть маршрута уже прошла.

Связанные руководства

Сверено по официальной документации авторов. Совместимость указана для примера на странице.