Discourse Frotz 🧙

[merefield (Robert)]

우와, 새로운 플러그인입니다! 이번 것은 조금 더 가벼운 분위기입니다.

Discourse Frotz

^{이제 매 단계마다 봇을 @멘션할 필요가 없습니다. 게임이 시작되면 봇의 게시물에 답글을 달기만 하면 됩니다.}

Git 저장소: GitHub - merefield/discourse-frotz: A plugin that uses Frotz to give you an interactive fiction experience on your Discourse forum · GitHub

###这是什么

이것은 Discourse 포럼에서 인터랙티브 픽션(즉, 클래식 텍스트 어드벤처 게임)을 플레이하기 위한 '봇’이며, David Griffith / frotz · GitLab 에 있는 표준적이고 놀라운 Z-머신 인터프리터인 'frotz’에 대한 어댑터 역할을 합니다.

사용 방법

설정을 통해 두 개의 게임이 추가되며, 설정에서 더 많은 게임을 추가할 수 있습니다.

각 항목에는 제목과 스토리 파일 이름이 포함되어 있습니다.

상호작용을 시작하려면 설정에서 지정한 봇을 @멘션해야 합니다. 그 후, 봇의 게시물에 답글을 달기만 하면 됩니다.

사용 가능한 게임을 나열하려면 먼저 봇을 멘션하고 다음과 같이 질문해야 합니다:

@mybot list games

이렇게 하면 선택 가능한 옵션 목록이 표시됩니다.

게임을 시작하려면 다음과 같이 입력하세요:

start game x (x를 옵션 번호로 대체)

다른 게임으로 전환할 수도 있습니다. 이 플러그인은 모든 움직임마다 진행 상황을 저장하므로 언제든 첫 번째 스토리로 돌아갈 수 있습니다. 플러그인은 각 스토리별로 모든 사용자의 저장 파일을 유지합니다.

기존 게임을 계속하려면 다음과 같이 입력하세요:

continue game x (x를 옵션 번호로 대체)

참고: 전체 재빌드 시 모든 저장 파일이 삭제됩니다. 이는 불가피한 타협입니다.

IF 게임을 어떻게 플레이하나요?

많은 “Meta” 사용자들은 이런 게임들과 함께 자랐을 것입니다. 익숙하지 않은 분들을 위해 이 치트시트를 확인해 보세요: Play Some Interactive Fiction

설정

봇 사용자 생성

(사과드립니다, 이 과정의 자동화는 제 할 일 목록에 있습니다!)

ssh 세션에서 컨테이너와 rails 콘솔에 진입하세요:

./launcher enter app
rails c

그런 다음 다음을 수행하세요:

u = User.create!(username: "Frotz", name: "FrotzBot", id:-5, email: "not@really.valid")
u.activate

이제 새로 생성된 봇을 UI에서 설정할 수 있습니다. 관리 버튼으로 사용자 설정으로 이동하여 모든 이메일 알림을 끄세요. 아바타를 취향에 맞게 업데이트하세요.

Discourse Frotz 설치

app.yml 업데이트

이것은 일반적인 플러그인보다 조금 더 침습적입니다.

app.yml에 다음을 추가하세요:

hooks:
  after_code:
    - exec:
        cd: $home
        cmd:
          - git clone https://gitlab.com/DavidGriffith/frotz
    - exec:
        cd: $home/frotz
        cmd:
          - make dfrotz
    - exec:
        cd: $home/frotz
        cmd:
          - mkdir savegames
    - exec:
        cd: $home/frotz
        cmd:
          - mkdir stories
    - exec:
        cd: $home/frotz/stories
        cmd:
          - wget -O zork1.z3 https://eblong.com/infocom/gamefiles/zork1-r119-s880429.z3
    - exec:
        cd: $home/frotz/stories
        cmd:
          - wget --no-check-certificate http://www.douglasadams.com/creations/hhgg.z3
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/merefield/discourse-frotz

다른 플러그인 항목 앞에 추가해야 합니다.

또한 Discourse BBCode 플러그인을 추가해야 합니다!!

일반적인 ./launcher rebuild app 명령으로 재빌드하세요.

이제 플러그인 설정으로 이동하여 이전에 추가한 봇 사용자를 선택하세요:

스토리

몇 개의 스토리를 포함했음을 알 수 있습니다. 더 많은 스토리는 https://ifdb.tads.org/ 에서 찾을 수 있습니다.
그러나, 여기서 속도 제한에 유의하세요! 같은 위치에서 너무 많은 스토리를 가져오면 오류가 발생할 수 있습니다.

또한 스토리가 HTTPS로 보호된 서버에 있지 않다는 점도 알아두세요(쯧쯧).

더 많은 스토리를 로드해야 한다면 app.yml에 추가하세요. 명령 프롬프트에서 수동으로 추가할 수도 있지만, 이는 다음 전체 재빌드 시 삭제된다는 점을 인지해야 합니다.

개인 메시지로 FrotzBot 활성화 (주의 필요)

사용자가 개인적으로 플레이할 수 있도록 하지만, 사용은 덜 투명해집니다. 서버가 충분히 크다면 이것이 문제가 되지 않을 수 있습니다. 어쨌든 용량에 대한 영향을 인지하세요. 대안으로, 지정된 카테고리에서 플레이하도록 사용자를 장려할 수 있습니다.

기본값: OFF

해당 사용자가 활성화되어 있지 않으면, 사용자는 정중한 메시지를 받게 됩니다:

카테고리별 FrotzBot 제한

다른 영역을 차지하지 않도록 봇을 (카테고리 목록으로) 제한할 수 있습니다:

키보드 단축키!

이것은 ‘게이밍’ 경험을 개선하는 데 정말 중요합니다. 그리고 실제로 기억해야 할 단축키는 두 개뿐입니다:

• Shift-R 봇에 답글 작성

• Ctrl-Enter 다음 움직임 제출

제한 사항 및 고려 사항

아직 모든 스토리 형식과 게임이 지원되지 않으며, 앞으로도 지원되지 않을 가능성이 있습니다. 호출 및 응답 프로토콜의 특성 때문에 작동하지 않는 게임이 많습니다. 게시물 단위로 상호작용하는 방식 때문에 Frotz가 각 움직임 후 상태를 저장하도록 요청해야 합니다. 게임의 한 단계가 시스템이 저장할 수 있는 프롬프트(임의의 키를 눌러 계속하거나 More 프롬프트는 처리되어야 하므로 무시)로 이어지지 않으면 스토리가 작동하지 않습니다. 예를 들어, Act of Murder(훌륭한 게임!)에서 문 앞의 여성이 당신이 경찰관인지 묻습니다. 불행히도 이것은 저장할 수 없는 게임 상태이므로 이 요구 사항을 충족하지 못하며, 이를 작동하게 만드는 방법을 찾을 수 없습니다.

참고: 메일링 리스트 모드는 이것과 함께 재앙 이므로, 이 플러그인을 사용하려고 시도하기 전에 이것이 사용되지 않도록 확인하세요!

각 'movement’마다 최소 두 개의 게시물이 필요하므로 포럼 리소스를 다소 낭비한다고 볼 수 있습니다. 당연히 이러한 유형의 게임은 포럼보다는 채팅 인터페이스를 사용하여 플레이하는 것이 더 적합한 경우가 많습니다. 하지만 이것이 워크스루(Walkthroughs)를 생성하는 데 사용될 수 있다고 주장할 수도 있겠죠?

덜 침습적인 솔루션을 원한다면 다음을 고려해 보세요: Turning a topic into interactive fiction ;)

피드백

모든 피드백을 환영합니다!

크레딧

이 플러그인은 설정 스크립트에서 클론되고 'make’되는 Frotz Z-인터프리터인 David Griffith / frotz · GitLab 를 활용합니다.

함께 작업한 클로즈드 소스 챗봇의 코드 발췌를 사용할 수 있도록 허락해 준 @P16 에게 감사드립니다.

[merefield (Robert)]

우와, 돌아왔군요!

새로운 기능들

개인 메시지에서 FrotzBot 활성화 (주의하세요! ;))

사용자가 개인적으로 플레이할 수 있도록 허용하지만, 사용 현황이 덜 투명해집니다. 서버 규모가 충분히 크다면 문제가 되지 않을 수 있습니다.

various fixes, code improvements and new feature to control use in private messages

기본값: OFF

해당 설정이 비활성화된 경우, 사용자는 정중한 안내 메시지를 받게 됩니다:

카테고리 목록으로 제한하거나, 모든 카테고리를 허용할 수 있습니다:

FEATURE: restrict public games by Category

기본값: 모든 카테고리 ON

[Benjamin_D (Benjamin Decotte)]

로버트님, 안녕하세요! 이 플러그인이 정말 마음에 듭니다!
Docker 없이 개발 환경에서 설치해 봤는데, dfrotz를 빌드할 때 시스템이 ncursesw 라이브러리를 요구하더군요. 해당 라이브러리를 설치한 후에는 정상적으로 작동했습니다. Docker를 사용하는 프로덕션 환경에서도 같은 문제가 발생할까요?

[merefield (Robert)]

프로덕션 환경에서 테스트해 보니, Docker로 빌드하는 과정이 (내 예상과 달리) 바로 잘 작동했습니다. 원하시는 경우 프로덕션 인스턴스에 배포해 보시고, 진행 상황을 알려주세요.

좋아해 주셔서 기쁩니다!!

[Benjamin_D (Benjamin Decotte)]

나처럼 그 일 때문에 마지막 몇 가닥 머리카락까지 잃을지도 모를 사람들을 위해:

@merefield

각 항목에는 제목, 스토리 파일 이름, 그리고 관리용 텍스트를 제거하여 사용자가 스토리 텍스트만 볼 수 있도록 반환된 텍스트를 정리하기 위한 세 가지 보정 설정이 포함되어 있습니다.

hhgg.z3,9,7,3
이는 다음과 같습니다:

  story_header_lines = 9
  story_load_lines = 7
  story_save_lines = 3

그리고 이제 어떻게 적용할지… , 모험 속의 모험이네요…!

[merefield (Robert)]

현재 Frotz의 유지보수자와 협력하여 그 부분을 제거할 수 있는지 확인하고 있습니다. restful-Frotz에서 가져온 방식이지만, 완벽하지는 않습니다

[Benjamin_D (Benjamin Decotte)]

네! 찾았어요!
kheper.z8,20,15,4 가 거의 작동합니다.
이 게임의 경우:

Kheper – Une aventure égyptienne – Fiction-interactive.fr

별것은 아니지만 뭔가 이상한 점이 있습니다.

) Line-type display OFF
Compression mode MAX, hiding top 0 lines

이 내용이 Pause()에 의해 한 번 표시됩니다.

[Pause notNeeded;
@read_char 1 notNeeded;
rtrue;
];

[merefield (Robert)]

하, 네, 이야기들에는 수많은 특이점과 상당한 다양성이 있습니다. 모두를 지원하겠다고 약속할 수는 없어요.

지금은 다음 사항에 집중하고 있어요:

1. 코드 단순화
2. 코드 보안 강화
3. 실용적인 부분에서 포맷팅 추가

#3번이 의외로 어렵습니다.

[merefield (Robert)]

기능 브랜치에 몇 가지 개선 사항을 푸시했습니다:

GitHub - merefield/discourse-frotz at formatting_security_and_simplification

이 변경 사항은 무의미한 억제(suppression) 설정을 제거하고, 서식 및 색상 지원을 위해 BBCode 번역을 도입하며, Dumb Frotz 명령줄 옵션을 더 잘 활용하고, 텍스트 스트림에 작성할 필요성을 없애며, 취약점을 수정합니다.

이 브랜치는 공식 BBCode 플러그인이 설치되어 있어야 합니다.

아직 실험 단계입니다. 여러분도 자유롭게 시도해 보세요.

충분한 테스트가 이루어진 후 병합할 예정입니다.

[elijah (Eli the Bearded)]

플러그인이 frotz 저장소 전체 클론을 필요로 하는 건가요, 아니면 $home/frotz/dfrotz만 존재하면 되는 건가요? 재빌드 사이에 바이너리를 저장해 두고 한 번만 컴파일하고 싶기 때문이거든요.

[merefield (Robert)]

왜 신경 쓰시는지 잘 모르겠네요. 우리가 이야기하는 리소스는 상대적으로 매우 작습니다. (make를 실행한 후 전체 저장소가 6MB인 반면, 포럼은 기가바이트 수준이니까요.) 이 과정은 저장소 전체를 클론한 후 dfrotz만 빌드합니다. 다소 낭비일 수는 있지만, 저는 단순성과 재현성이 더 중요하다고 생각합니다. 더 자세한 내용을 다루며 스파스 클론을 수행할 수는 있지만, 그렇게 하면 빌드 스크립트가 더 복잡해지고 견고성이 떨어집니다. 그럴 가치가 있을까요? 최적화에 대한 제안을 자유롭게 해주세요. 이 모든 작업은 컨테이너 내부에서 이루어지므로, 컨테이너가 정리될 때 함께 정리됩니다.

[elijah (Eli the Bearded)]

저는 제 작은 서버를 최적화하려는 것이지, 일반적인 설치 방식을 바꿔 달라고 하는 게 아닙니다.

[Chaboi_3000]

정말 멋진 플러그인입니다! 몇 년 전에 만들어졌던 “클래식” 컴퓨터 게임을 떠올리게 하네요(이름을 잊어버렸어요).

[merefield (Robert)]

단순하고 견고하게 유지할 수 있다면, 향후 최적화를 위한 훌륭한 제안입니다. 감사합니다!

[merefield (Robert)]

네, 플레이할 수 있는 클래식 게임이 많습니다. OP의 링크를 통해 더 많은 게임을 확인해 보세요.

[merefield (Robert)]

큰 업데이트:

(이 작업은 수개월간의 간헐적인 백그라운드 작업과 Frotz 팀과의 조율을 필요로 했습니다.)

스토리에 대한 전체 색상 및 고정폭 서식 지원 도입

Bbcode frotz (#2)

이번 대규모 업데이트에는 다음과 같은 여러 개선 사항이 포함되었습니다:

• 색상 서식 및 고정폭 텍스트 지원 추가
• 단순화된 설정 개선: 헤더와 푸터의 보정이 더 이상 필요하지 않으며, 원하는 제목과 스토리 파일만 지정하면 됩니다!
• 시스템 명령을 위해 Open3 gem을 사용하여 악용/취약점 발생 위험 감소
• 커맨드 라인과의 내부 상호작용 개선: 스트림 파일의 필요성을 제거하고, 더 많은/아무 키나 누르기 프롬프트를 처리할 수 있도록 개선

이제 Discourse BBCode 플러그인이 필수입니다!!

이 작업에는 Frotz의 유지보수자 David Griffiths와 해당 커뮤니티의 매우 활동적인 멤버 중 한 명인, BBCode Discourse 표준에 기반한 BBCode 확장 기능을 작성한 Borg323의 협업이 필요했습니다. 두 분께 진심으로 감사드립니다! 고정폭 텍스트 기능을 작동시키기 위해 다소 창의적인 방법을 사용해야 했지만, 해결책은 정말 훌륭합니다!

새로운 서식의 몇 가지 예시입니다(이 스토리들은 완전히 테스트되지 않았으며, 서식 예시일 뿐입니다)

여기서 색상으로 표시된 나침반을 주목해 보세요:

알려진 문제: 호출 및 응답 프로토콜의 특성 때문에 작동하지 않는 게임이 많습니다. 게임의 한 단계가 저장할 수 있는 프롬프트로 이어지지 않는 경우(처리되어야 하는 아무 키나 누르기 또는 More 프롬프트를 무시하고), 해당 스토리는 작동하지 않습니다. 예를 들어 Act of Murder(훌륭한 게임!)에서 문 앞의 여성이 경찰인지 묻습니다. 불행히도 이 게임 상태는 저장할 수 없어 이 요구사항을 충족하지 못하며, 이를 작동시킬 방법을 찾을 수 없습니다.

이전에는 호환되지 않았으나 이제 Discourse Frotz와 호환되는 게임들이 있을 수 있습니다 … 위 제한 사항을 유의하시면서 실험해 보세요!

작동 중 문제가 발생하면 알려주세요. 필요에 따라 설명서를 개선하겠습니다.

[merefield (Robert)]

이 플러그인에서 키보드 단축키를 사용하여 사용 경험을 향상시킬 수 있다는 점을 상기해 드립니다:

• Shift-R: 봇에 답장하기

• Ctrl-Enter: 다음 수를 제출하기

(기본 제공 키보드 단축키).

[Benjamin_D (Benjamin Decotte)]

로버트, 안녕하세요!
드디어 시간을 내서 더 진행해 보았는데, 지금까지는 잘 되고 있습니다. 프로덕션 환경에서 바로 정상 작동했어요

이상하게도 frotz는 어떤 범주에라도 설정을 함께 하지 않으면 개인 메시지에 응답하지 못합니다
다음 단계: 플레이해 보기

[merefield (Robert)]

리포트 감사합니다!

해당 문제를 수정했습니다: FIX: behaviour of private messages playing permission setting · merefield/discourse-frotz@34b022e · GitHub

NTS: 단위 테스트를 추가해야 합니다!

[Benjamin_D (Benjamin Decotte)]

소스에서 :grin:을 추가해 봤어요.

재밌을 것 같아요!