CC SmartCard

CC SmartCard

Программируемые смарт-карты, сканеры личности, датчики прохода и шлагбаумы для CC: Tweaked.

В отличие от диска CC, владелец которого может свободно читать и записывать его общее хранилище, смарт-карта записывается только один раз при выдаче. Её содержимое нельзя затем прочитать напрямую или произвольно изменить; она может только выполнять команды, определённые при выдаче, что даёт иную границу безопасности и модель использования.

Она предназначена для карт доступа в стиле ComputerCraft, проверок личности, билетов, токенов, банковских систем и других построек, которым нужно больше, чем просто ID предмета.

Смарт-карты

• Дайте каждой карте публичный ID и необязательную метку.
• Красьте карты, не меняя их личность, программу или хранимые файлы.
• Выдавайте карту из одной строки исходника Lua или из директории с файлами.
• Держите выданную программу и её хранилище закрытыми от обычного API считывателя.
• Запускайте программы карты независимо от вызывающего компьютера.

Выданные карты нельзя стереть или перевыдать через поддерживаемый API считывателя.

Считыватель смарт-карт

Поставьте считыватель рядом с компьютером CC: Tweaked или подключите его через проводной модем. Вставляйте или вынимайте карту правым кликом по любой грани считывателя.

Периферия smart_card_reader может просматривать публичные метаданные карты, выдавать пустую карту, вызывать команды на выданной карте и генерировать события вставки или извлечения.

local reader = peripheral.find("smart_card_reader")
assert(reader, "No Smart Card Reader found")

local message, cardId = reader.call("ping")
print(message, cardId)

Сканер отпечатков пальцев

Периферия fingerprint_scanner ждёт, пока игрок кликнет правой кнопкой по сканеру, ненадолго подсвечивает свою сканирующую грань и возвращает стабильный UUID игрока вместе с его текущим именем профиля.

local scanner = peripheral.find("fingerprint_scanner")
local player = assert(scanner.scan())
print(player.name, player.uuid)

Шлагбаумы и датчики прохода

Стройте автоматизированные полосы пограничного контроля, защищённые тамбуры, барьеры станций или любой другой двухступенчатый проход. В демонстрации используются два независимых шлагбаума и один датчик прохода: вход начинает открытым, закрывается после входа одного игрока, компьютер внутри разрешает выход, и полоса сбрасывается после ухода игрока.

Поставьте два шкафа шлагбаума друг напротив друга через промежуток в один или два блока, чтобы сформировать одну анимированную периферию access_gate. Оба шкафа управляют одним логическим шлагбаумом.

• Стеклянные створки открываются или закрываются асинхронно за 10 игровых тиков.
• Заблокированные створки автоматически разворачиваются и открываются заново.
• Лампы шкафа показывают красный при закрытии, янтарный при движении или сбоях и зелёный при открытии.
• Шлагбаумы игнорируют редстоун и не могут быть сдвинуты прямым взаимодействием игрока.
• Когда последний подключённый компьютер отключается, шлагбаум ждёт одну секунду и открывается при отказе.
• Изменения состояния шлагбаума и препятствия доступны как события ComputerCraft.

Два шлагбаума остаются независимыми: ваша программа на Lua решает, как работает аутентификация и может ли быть открыт только один шлагбаум. Это делает блоки полезными за пределами единственного жёстко заданного сценария пограничного контроля.

Установи passage_sensor над контролируемым пространством, чтобы получать анонимные наблюдения за игроками, существами, транспортом, предметами и другими сущностями. Его кубоид обнаружения настраивается из Lua — до 256 блоков в пределах восьми блоков от сенсора. Программы могут запрашивать снимок через getEntities() или реагировать на события входа, выхода и сброса. Lua решает, что считается путешественником; сенсор никогда не раскрывает UUID игроков, имена, экипировку, инвентари или NBT.

Как работают карты

1. Скрафти Smart Card и Smart Card Reader.
2. Подключи компьютер CC: Tweaked к считывателю.
3. Вставь пустую карту и один раз запусти её Lua-программу.
4. Вставь выпущенную карту в другие считыватели и вызывай команды вроде authorize, validate, claim или redeem.

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

Идеи для построек

• Банковские карты и магазинные терминалы
• Ключи от комнат и пропуска доступа
• Билеты на поезд и пропуска на мероприятия
• Токены выдачи посылок
• Двухфакторные системы, сочетающие Smart Card со сканированием отпечатка пальца в реальном времени
• Автоматизированные полосы пограничного контроля и проходы с двумя взаимосвязанными воротами
• Пропускные ворота тюрем, банков, складов и станций

Крафт

На изображении показаны оригинальные блоки карт и идентификации. Рецепты Gate Cabinet и Passage Sensor приведены в текстовой справке ниже.

###
#R#
#C#

SCS
RGR
SCS

SGS
PRP
SCS

CGC
ROR
SSS

Требования

• Minecraft 1.21.1
• NeoForge 21.1.235 или новее в линейке 21.1
• CC: Tweaked 1.120.0 или новее
• Java 21

Установи CC SmartCard на сервер. Клиентам в мультиплеере также стоит установить его, чтобы были доступны его блоки, предметы, модели и переводы.

Документация

Полный README и справочник по API охватывают выпуск карт, события считывателя, все методы периферии, API среды выполнения карты, структуру файлов и полные примеры.

Исходный код · Трекер задач

Приватность карт — это игровая граница, а не формальная защита от администраторов сервера или другого доступа вне игры.