[💬] Love2D 모듈 알아보기: filesystem 1편

[토끼주문(icyselec)]

Love2D 모듈 알아보기: filesystem 1편

filesystem 모듈은 단순히 Love2D의 파일 관리를 수행할 뿐만 아니라, 게임 초기화 및 실행에도 일정 부분 관여한다.

이 모듈의 기능을 잘 활용하면, 게임의 자원 관리를 더 수월하게 할 수 있을 뿐만 아니라 게임을 쉽게 모듈화할 수 있어 게임 커뮤니티의 활발한 모드 지원을 받는데 유리하다.

[모듈 설명]
(번역됨, 의역 및 오역 있을 수 있음)
사용자의 파일에 대한 인터페이스를 제공합니다.

filesystem 모듈에서는 특정 경로에 대한 파일만 접근할 수 있습니다.
(1). '.love' 압축 파일의 최상위 디렉터리 또는 소스코드가 있는 디렉터리.
(2). 게임 세이브 경로의 최상위 디렉터리 (세이브는 일반적으로 세이브 파일만 저장하는 곳이 아닙니다.)
(3). '.love' 파일이 위치한 디렉터리. 단, 이 경우는 fused 된 경우에만 적용됩니다.

수정과 관련된 작업을 하는 경우, 생성된 파일은 세이브 디렉터리 내에 있습니다. 파일에 접근할 때, '.love' 파일 내에 파일 이름과 세이브 디렉터리 내에 있는 파일의 이름이 같을 경우, 세이브 디렉터리의 파일을 우선시합니다.

(get*Directory 형식의 함수를 제외하고) 모든 경로는 '.love' 압축 파일과 세이브 디렉터리와 연관되어 작동합니다. 따라서, 올바른 위치에 저장되기 위해서는 conf.lua에서 identity를 설정하거나 setIdentity 함수를 호출하는게 좋습니다.

[함수 목록]
append
areSymlinksEnabled
createDirectory
getAppdataDirectory
getCRequirePath
getDirectoryItems
getIdentity
getInfo
getRealDirectory
getRequirePath
getSaveDirectory
getSource
getSourceBaseDirectory
getUserDirectory
getWorkingDirectory
init
isFused
lines
load
mkdir
mount
newFile
newFileData
read
remove
setCRequirePath
setIdentity
setRequirePath
setSource
setSymlinksEnabled
unmount
write

[예제 소스코드]
아래 소스코드는 게임에 모딩 기능을 추가하는 간단한 예시이다. filesystem 모듈에서 제공하는 기능이 얼마나 강력하고 유용한지를 알려주는 예시다. 게임의 확장 코드가 게임 외부에 있으며, 게임 실행 중에 동적으로 로드가 가능하다.

예제 소스코드는 설명을 위해 일부러 단순하게 설계했지만 견고하게 설계한다면 충분히 모드로더의 기능도 해낼 수 있다. (아예 그런 쪽으로 써먹으라고 했는지 load, setRequirePath, mount, getSourceBaseDirectory 등의 기능을 제공한다.)

실행을 위해서는 main.lua 파일을 ZIP 파일로 압축하고, '--fused' 옵션을 주어 실행하여야 한다.

소스 코드를 보면 게임의 로직을 확장하는 코드가 게임 외부에 있음을 알 수 있다. hello.lua는 게임 파일 외부에 mods 디렉터리에 존재한다.

filesystem 2편은 나중에 다루기로 하고 다음에는 data 모듈 알아보겠음...

분량이 적은 이유는 어제 급하게 만드느라 그랬고 안올려져서 못올린걸 지금 올리는거

[토끼주문(icyselec)]

세상에... 'love.filesystem.' 이거 때문에 안올라갔다니... 디시 서버 개판이네

[익명(58.29)]